Przejdź do treści głównej

Kontynuuj klip z Seedance 2.0 Fast: ostatnia klatka twojego wideo otwiera nowy fragment trwający od 4 do 15 sekund, a w odpowiedzi dostajesz jeden plik z połączonym oryginałem i kontynuacją, w 480p lub 720p.

Od $0.045/s

Obszar roboczy

Wyślij żądanie

Szybki start

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY
# 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-fast/video-extend",
  "input": {
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "generate_audio": true,
    "resolution": "720p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# 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"

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Parametry wejściowe

Te pola umieść w obiekcie input w ciele żądania. Nazwy i typy odpowiadają API. Gdy wartości domyślnej nie podano, nie zakładaj żadnej.

video_urlstringWymagane

Klip do kontynuowania: MP4, MOV lub WebM, do 60 sekund. Jego ostatnia klatka staje się klatką początkową nowego fragmentu, więc przytnij go na czystej, ostrej klatce. Oryginał nie jest rozliczany.

Domyślnie
Nie określono
Ograniczenia
minLength:1
format:"uri"
contentMediaType:["video/mp4","video/webm","video/quicktime"]
watermarkbooleanOpcjonalne

Dodaje do wideo widoczny znak wodny „AI generated” samego modelu. Domyślnie wyłączone; włącz, gdy miejsce publikacji wymaga oznaczania materiałów wygenerowanych przez AI. Nie wpływa na cenę.

Domyślnie
false
bitrate_modestringOpcjonalne

Bitrate dostarczanego pliku: `standard` (domyślnie) albo `high`. `high` przy tej samej rozdzielczości zachowuje ostrzejsze drobne faktury i szybki ruch, a plik jest wyraźnie większy; rozdzielczość, liczba klatek na sekundę i długość się nie zmieniają. Nie wpływa na cenę.

Domyślnie
"standard"
Dozwolone wartości
"standard""high"
seedintegerOpcjonalne

Całkowity seed; pominięty – każdy przebieg losuje własny. Ustal go przy wszystkim innym bez zmian, żeby ocenić, co naprawdę zmieniła poprawka w prompcie. To narzędzie do porównań, a nie obietnica powtórzeń identycznych klatka w klatkę.

Domyślnie
Nie określono
Ograniczenia
minimum:0
maximum:2147483647
generate_audiobooleanOpcjonalne

Domyślnie włączone, więc nowy fragment dostaje ścieżkę dźwiękową zsynchronizowaną z obrazem; wyłączenie nie obniża ceny w tym wariancie. Oryginał w każdym przypadku zachowuje własny dźwięk; jeśli jedna strona jest cicha, połączony plik jest wypełniany ciszą.

Domyślnie
true
duration_secondsintegerOpcjonalneWpływa na cenę

Długość nowego fragmentu w pełnych sekundach, od 4 do 15; domyślnie 5. Wartość -1 oddaje wybór modelowi: wtedy 15 sekund jest rezerwowanych z góry, a opłata wyrównuje się do dostarczonej długości. Twój oryginał dochodzi przed nim i nie jest rozliczany.

Domyślnie
5
Dozwolone wartości
-1456789101112131415
resolutionstringOpcjonalneWpływa na cenę

Rozdzielczość nowego fragmentu: 480p lub 720p, domyślnie 720p. Od niej zależy cena. Dopasuj ją do oryginału, żeby łączenie pozostało ostre: niższe ustawienie wygląda miękko obok oryginału, a wyższe nie dodaje szczegółów, których nie ma w ostatniej klatce.

Domyślnie
"720p"
Dozwolone wartości
"480p""720p"
last_image_urlstringOpcjonalne

Opcjonalna klatka końcowa: nowy fragment kończy się na tym obrazie, w ten sposób wskazujesz, gdzie ma lądować ujęcie, na przykład przejście, para przed i po albo spokojna poza. Utrzymaj stabilną kamerę i światło między ostatnią klatką klipu a tym obrazem i zmień jeden wyraźny stan, bo inaczej środek zamieni się w cięcie. Każdy bok musi mieć od 300 do 6000 pikseli; mniejszy obraz odrzuca kontrola wejścia, zanim cokolwiek zostanie rozliczone.

Domyślnie
Nie określono
Ograniczenia
contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]
promptstringOpcjonalne

Opcjonalny, ale warto go napisać: co dzieje się dalej, czyli następna akcja, ruch kamery i dźwięk. Obiekt i scenografię ustala już klatka początkowa, więc słowa przeznacz na ruch. Bez promptu model sam decyduje o ruchu.

Domyślnie
Nie określono
Ograniczenia
minLength:1

Śledź zadanie

HTTP 202 oznacza, że zadanie zostało przyjęte, a nie ukończone. Zapisz zwrócone taskId i odpytuj właśnie to zadanie. Nie twórz kolejnego zadania, czekając na jego wynik.

Odpowiedź o przyjęciu
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

Odpowiedź o przyjęciu zawiera szacunek, dzięki czemu twoja aplikacja pokaże tę samą kwotę w historii zadań i w rozliczeniach.

Odczytaj zadanie
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Zacznij odpytywać mniej więcej co 2 sekundy i stopniowo wydłużaj odstęp. Zatrzymaj się na stanie końcowym. Po zerwaniu połączenia odpytaj pierwotne taskId. Tworzenie ponawiaj wyłącznie z pierwotnym kluczem idempotentności i pierwotnym ciałem żądania.

Albo odbierz wynik przez callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Podaj callBackUrl przy tworzeniu zadania, a gotowy rekord przyjdzie do ciebie metodą POST – bez żadnej pętli odpytywania. Każda dostawa niesie X-Webhook-Timestamp, X-Webhook-Signature i X-Webhook-Payload-Version. Podpis to HMAC-SHA256 w base64 z taskId.timestamp.sha256(body), więc trzeba go sprawdzać na surowych bajtach: sparsowanie JSON-a i ponowne zserializowanie zmienia je i weryfikacja się nie powiedzie. Nieudane dostawy są ponawiane, więc to samo taskId może przyjść dwa razy – zrób obsługę idempotentną. Najpierw odpowiedz kodem 2xx, a pracę wykonaj potem; wolna obsługa jest traktowana jak nieudana dostawa.

Odczytaj wynik

Wynik wykorzystuj dopiero przy stanie succeeded. Przy niepowodzeniu skorzystaj z errorCode, errorMessage i request_id. Przykładowe koszty i stany nie odpowiadają rzeczywistemu rozliczeniu.

Przykład odpowiedzi po zakończeniu
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.0-fast/video-extend",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Każdy dostępny materiał otwieraj lub pobieraj bezpośrednio spod assets[].url, bez nagłówka Authorization. Podpisany adres wygasa o expiresAt; odpytaj zadanie ponownie, żeby go odświeżyć, dopóki materiał mieści się w okresie przechowywania. Materiał oczekujący lub niedostępny nie ma adresu. Podpisane adresy traktuj jako prywatne.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wyszukaj na płótnie Seedance 2.0 Fast · Video Extend. Węzeł ma te same opcje co ta strona i pokazuje cenę, zanim ruszy.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi