API Seedance 2.5: wideo NSFW bez cenzury do 30 s

bytedance/seedance-2.5/image-to-video

Seedance 2.5 image-to-video od ByteDance startuje klip z przesłanego obrazu i go animuje, z dźwiękiem w tym samym przebiegu. Klipy 4–30 sekund w 480p, 720p lub 1080p, a opcjonalny obraz końcowy sprawia, że ujęcie kończy się na wskazanej klatce.

Od $0.123/s

Uruchom model Zobacz API

Wyślij żądanie

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

Przykładowy wynik

# 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.5/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "output_format": "mp4",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
  }
}'

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

image_urlstringWymagane

Pole wymagane; staje się pierwszą klatką wideo. Stamtąd biorą się kompozycja, podobieństwo i kolor, co wyznacza też sufit jakości wyniku: lepiej dopracować ten kadr, niż potem łatać wynik słowami w prompcie. Użyj ostrego kadru z czytelnym tematem i bez widocznych artefaktów kompresji. Własna kontrola wejścia Seedance może odrzucić zdjęcie, na którym widać twarz prawdziwej, rozpoznawalnej osoby. Każdy bok musi mieć od 300 do 6000 pikseli; mniejsze pliki odrzuca kontrola wejściowa, zanim zostanie naliczona jakakolwiek opłata.

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

watermarkbooleanOpcjonalne

Prosi model o oznaczenie wideo znakiem wodnym treści wygenerowanej przez AI, zgodnie z dokumentacją 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

return_last_framebooleanOpcjonalne

Oprócz wideo zwraca ostatnią klatkę klipu jako osobny obraz. Wyślij ją do image-to-video jako kolejną klatkę początkową, żeby łączyć ujęcia bez samodzielnego eksportowania kadru. Domyślnie wyłączone; nie wpływa na cenę.

Domyślnie: false

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

enable_web_searchbooleanOpcjonalne

Domyślnie wyłączone. Po włączeniu model może przed renderem wyszukać w sieci informacje związane z promptem. Nie zmienia ceny.

Domyślnie: false

output_formatstringOpcjonalne

Kontener zwracanego wideo: mp4 (domyślnie) albo mov. Obraz jest w obu taki sam; mov zapisuje ścieżkę dźwiękową jako nieskompresowany PCM, więc plik jest nieco większy i trafia bezpośrednio do programów montażowych, które wolą QuickTime. Nie zmienia ceny.

Domyślnie: "mp4"
Dozwolone wartości: "mp4""mov"

generate_audiobooleanOpcjonalne

Domyślnie włączone. Tworzy własną ścieżkę dźwiękową zsynchronizowaną z obrazem – tło pomieszczenia, efekty ruchu, głos. Wyłącz je przy materiałach produktowych, które i tak dostaną dźwięk w postprodukcji; zostaw włączone, gdy kroki i tło są częścią zamysłu.

Domyślnie: true

duration_secondsintegerOpcjonalneWpływa na cenę

Od 4 do 30 sekund, domyślnie 5. Im dłużej trwa ujęcie prowadzone klatką, tym bardziej dryfuje – anatomia i scenografia deformują się stopniowo. Potwierdź kierunek ruchu na 5 sekundach, dopiero potem wydłużaj. Przy naprawdę długich sekwencjach kilka krótszych ujęć zmontowanych jedno po drugim zwykle trzyma się lepiej niż jedno 30-sekundowe ujęcie. Długość skaluje rozliczaną wielkość liniowo.

Domyślnie: 5
Dozwolone wartości: 456789101112131415161718192021222324252627282930

resolutionstringOpcjonalneWpływa na cenę

480p, 720p lub 1080p, domyślnie 720p; wartość ta wprost zasila rozliczaną wielkość. Pamiętaj, że próg wyjściowy jest niezależny od kadru źródłowego: miękka klatka w niskiej rozdzielczości wyrenderowana w 1080p to po prostu powiększona miękkość. Wybrany próg jest progiem renderu – bez upscalingu i bez warstwy poprawiania obrazu na wierzchu.

Domyślnie: "720p"
Dozwolone wartości: "480p""720p""1080p"

aspect_ratiostringOpcjonalne

Przyjmowana jest tu wyłącznie wartość `adaptive`: Seedance 2.5 zawsze kadruje klip image-to-video według geometrii klatki otwierającej, a stały kształt kończy zadanie błędem. Jeśli format docelowy jest ustalony, przytnij albo poszerz kadr przed wysłaniem. Bez wpływu na rozliczenie.

Domyślnie: "adaptive"
Dozwolone wartości: "adaptive"

last_image_urlstringOpcjonalne

Opcjonalny kadr docelowy, którego **nie można wysłać samodzielnie** – jest ważny wyłącznie razem z `image_url`. Podaj oba, a model ułoży przejście z jednego do drugiego, co sprawdza się przy przemianach, unboxingach i ujęciach „przed i po”. Pomiń go, a o zakończeniu zdecyduje prompt. Kadry mocno różniące się kompozycją albo światłem sprawiają, że środek przejścia staje się nieprzewidywalny. Każdy bok musi mieć od 300 do 6000 pikseli; mniejsze pliki odrzuca kontrola wejściowa, zanim zostanie naliczona jakakolwiek opłata.

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

promptstringOpcjonalne

Tutaj opcjonalny, ale warto go napisać: powinien opisywać to, co dzieje się po klatce, a nie powtarzać to, co już widać: akcję, ruch kamery, upływ czasu, dźwięk. Bez niego ruch wybiera sam model. Skoro obraz jest już ustalony kadrem, to właśnie ta droga wytrzymuje śmielsze briefy – sformułowania, które warstwa bezpieczeństwa Seedance odrzuca przy pustej stronie, zwykle przechodzą, gdy treść niesie sama klatka.

Domyślnie: Nie określono

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "adaptive",
      "description": "Aspect ratio of the generated video. Seedance 2.5 frames an image-to-video clip on the first frame, so adaptive is the only accepted value.",
      "enum": [
        "adaptive"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 70,
        "widget": "select"
      }
    },
    "duration_seconds": {
      "default": 5,
      "description": "Clip length in seconds. This is the billed quantity.",
      "enum": [
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25,
        26,
        27,
        28,
        29,
        30
      ],
      "type": "integer",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 50,
        "unit": "s",
        "widget": "slider"
      }
    },
    "enable_web_search": {
      "default": false,
      "description": "Let the model search the web for information related to the prompt before rendering.",
      "type": "boolean",
      "x-ui": {
        "advanced": true,
        "affects_price": false,
        "order": 35,
        "widget": "switch"
      }
    },
    "generate_audio": {
      "default": true,
      "description": "Generate a native soundtrack synchronised to the picture.",
      "type": "boolean",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 40,
        "widget": "switch"
      }
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "URL of the image used as the first frame.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 90,
        "widget": "upload"
      }
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "URL of the image used as the closing frame. Only accepted together with image_url.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 80,
        "widget": "upload"
      }
    },
    "output_format": {
      "default": "mp4",
      "description": "Container of the returned video.",
      "enum": [
        "mp4",
        "mov"
      ],
      "type": "string",
      "x-ui": {
        "advanced": true,
        "affects_price": false,
        "order": 36,
        "widget": "radio"
      }
    },
    "prompt": {
      "description": "What to generate: subject, action, camera movement and mood.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 100,
        "primary": true,
        "widget": "textarea"
      }
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. Super-resolution tiers are not offered.",
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 60,
        "widget": "radio"
      }
    },
    "return_last_frame": {
      "default": false,
      "description": "Also return the clip’s final frame as a separate image.",
      "type": "boolean",
      "x-ui": {
        "affects_price": false,
        "order": 26,
        "widget": "switch"
      }
    },
    "seed": {
      "description": "Random seed. Omit to let the model pick one.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "affects_price": false,
        "order": 30,
        "widget": "number"
      }
    },
    "watermark": {
      "default": false,
      "description": "Ask the model to watermark the video as AI-generated.",
      "type": "boolean",
      "x-ui": {
        "advanced": true,
        "affects_price": false,
        "order": 22,
        "widget": "switch"
      }
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "duration_capped",
    "variantFields": [
      "resolution",
      "generate_audio"
    ]
  }
}

Ś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.5/image-to-video",
    "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.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Przeglądaj gotowe przepływy pracy

Nie musisz pisać żadnego z powyższych fragmentów kodu. Wystarczy raz podłączyć serwer MCP, a każdy agent obsługujący MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — może uruchomić ten model po nazwie. Można go też wywołać z powłoki jednym poleceniem.

Powiedz to swojemu agentowi

Użyj bytedance/seedance-2.5/image-to-video, żeby ożywić ./poster.png – powolny najazd, pięć sekund – i zapisz klip obok pliku źródłowego.

Agent znajduje model w aktualnym katalogu, sam wysyła plik lokalny, a potem pokazuje dokładną wycenę wraz z maksymalną opłatą i czeka na twoje potwierdzenie. Nic nie zostaje naliczone, dopóki nie zgodzisz się wprost.

Podłącz raz

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

Pierwsza linia daje agentowi narzędzia; druga daje mu Skill, czyli reguły ich używania: najpierw wycena, potem opłata, wysyłanie plików lokalnych zamiast wklejania bajtów i odczyt gotowego adresu materiału zamiast zgadywania. Każdy inny klient podłącza ten sam serwer przez własny plik konfiguracyjny – zobacz centrum dla deweloperów.

Albo jedno polecenie w powłoce

npx @spicyapi/cli tasks create --model bytedance/seedance-2.5/image-to-video \
  --input-json '{"aspect_ratio":"adaptive","duration_seconds":5,"generate_audio":true,"image_url":"https://example.com/reference.png","output_format":"mp4","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise"}' \
  --wait

Wejściem jest własny schemat tego endpointu, ten sam co w przykładach powyżej. --wait odpytuje aż do zakończenia zadania i wypisuje wynik; dodaj --yes, żeby pominąć pytanie o potwierdzenie w CI. Najpierw ustaw SPICY_API_KEY – jeden klucz działa w API, w CLI i na serwerze MCP.

Pliki lokalne

npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3

npx @spicyapi/cli tasks create --model bytedance/seedance-2.5/image-to-video \
  --input-json '{"image_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
  --wait

Ciało żądania przyjmuje adresy, a nie bajty. Najpierw wyślij plik i podaj wypisany identyfikator spicy:// – nazwa pola powyżej pochodzi wprost ze schematu tego endpointu. Agent na MCP robi ten krok za ciebie, dlatego zdanie wyżej może wskazać ./poster.png bezpośrednio. Media dostępne już publicznie po HTTPS nie wymagają wysyłania.

Jak długo przechowujemy wyniki

npx @spicyapi/cli tasks create --model bytedance/seedance-2.5/image-to-video \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

--retention potrafi wyłącznie skrócić okno – 30m, 1h, 7d albo 0, żeby usunąć zaraz po osiągnięciu przez zadanie stanu końcowego. Obowiązuje najkrótsza z trzech wartości: twojego żądania, ustawień konta i maksimum platformy, więc odczytaj ją z rekordu zadania, zamiast zakładać, że podana liczba zadziałała. Podanie okna dłuższego, niż pozwala konto, nic nie zmienia.

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wyszukaj na płótnie Seedance 2.5 · Image to Video. 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

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/seedance-2-5/api?model=bytedance%2Fseedance-2.5%2Fimage-to-video" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Śledź zadanie

Odczytaj wynik

SDK i integracje

Użyj w ComfyUI