Seedance 2.0 Mini API

Seedance 2.0 Mini w trybie referencje na wideo łączy kilka autoryzowanych źródeł w jedno ujęcie: obrazy mówią kto i co, klipy dają ruch i tempo, dźwięk wyznacza akcent, na którym ląduje cięcie. Nie przyjmuje pierwszej klatki.

Seedance 2.0 Mini to najmniejszy wariant linii Seedance 2.0 od ByteDance. Udostępnia te same endpointy co Seedance 2.0 Fast i zwraca klipy od 4 do 15 sekund w 480p lub 720p, z dźwiękiem generowanym w tym samym przebiegu.

Wybierz tryb Seedance 2.0 Mini według materiału wyjściowego

Ten sam kontrakt co Seedance 2.0 Fast

Mini udostępnia te same endpointy i pola co Seedance 2.0 Fast: adaptacyjne proporcje i sześć stałych, od 4 do 15 sekund lub -1 dla długości wybranej przez model, natywny dźwięk i seed, a rozdzielczość kończy się na 720p. Pipeline napisany pod Mini przeniesiesz do Fast, zmieniając identyfikator modelu, a nie żądanie.

Stworzony do dużych wolumenów

Mini wybierasz, gdy przepustowość liczy się bardziej niż dodatkowa jakość większych modeli Seedance 2.0. Każdy endpoint jest asynchroniczny: wysyłaj Idempotency-Key z każdym żądaniem, zapisuj identyfikatory zadań i odbieraj wyniki przez polling lub callbacki. Klucz działa 24 godziny, więc ponowna próba po zerwanym połączeniu zwraca pierwotne zadanie.

Dłuższe sekwencje z przedłużaniem wideo

Żeby wyjść poza piętnaście sekund, wyślij gotowy klip do endpointu video-extend: jego ostatnia klatka otwiera nowe ujęcie Seedance 2.0 Mini, a w odpowiedzi dostajesz jeden plik z połączonymi częściami. Każdy krok rozlicza tylko sekundy, które dodaje, a połączony wynik można przedłużyć ponownie.

Jeden zestaw referencji na całą serię

Trzy widoki jednego mężczyzny — z przodu, w trzech czwartych i z profilu — oraz czwarte zdjęcie jego fartucha mogą nieść całą serię, a między żądaniami zmienia się tylko prompt. Opublikowany przykład z piekarnią jest zbudowany dokładnie tak.

Tempo pożyczone z klipu

Klip referencyjny może dostarczyć rytm zamiast treści. Jeden z przykładów przejmuje z klipu spokojny, ciągły najazd, inscenizuje go w alejce z obrazu referencyjnego i kładzie kroki na pulsie referencyjnej ścieżki — osiem sekund w 9:16.

Para stabilna z różnych stron

Trzy zdjęcia tej samej pary pozwalają nowemu ujęciu znaleźć trzeci kąt, a twarze i stroje pozostają te same, jak w przykładzie z ławką w parku wygenerowanym w 480p.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "enable_web_search": false,
    "generate_audio": true,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ]
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.