API Seedance 1.5 Pro: wideo NSFW bez cenzury, stała kamera

bytedance/seedance-1.5-pro/image-to-video

Seedance 1.5 Pro image-to-video od ByteDance startuje klip z przesłanego obrazu i go animuje. Klipy 4–12 sekund w 480p, 720p lub 1080p z natywnym dźwiękiem, a blokada kamery zachowuje kadr dokładnie tak, jak go skomponowano.

Od $0.011/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-1.5-pro/image-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p"
  }
}'

# 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

Publiczny, bezpośrednio pobieralny link do pierwszej klatki; wymagany. Ustala kompozycję, wygląd postaci, kolorystykę i sufit jakości klipu – miękkie albo mocno skompresowane źródło widać w ruchu w powiększeniu. Tekst, znaki wodne i logotypy obecne w kadrze przechodzą do wideo, więc tam, gdzie możesz, usuń je wcześniej. Plik powinien mieć mniej niż 10 MB i format JPEG, PNG albo WebP.

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

promptstringWymagane

Wymagany, i powinien mówić, co dzieje się po klatce, a nie powtarzać to, co już widać: czynność, upływ czasu, dźwięk. Przy camera_fixed ustawionym na true trzymaj każdy opisywany ruch wewnątrz kadru – instrukcja dla kamery i zablokowana kamera ciągną w przeciwne strony. Ponieważ kadr i tak ustala obraz, to również droga, która wytrzymuje briefy bez cenzury.

Domyślnie: Nie określono
Ograniczenia: minLength:3

seedintegerOpcjonalne

Liczba całkowita od 0 do 2147483647 dla losowego startu; pominięta – każdy przebieg losuje własną. Trzymaj ją stałą, zmieniając jedną rzecz naraz, żeby zobaczyć, co dała ta zmiana – utrwala początkowy szum, a nie klip klatka w klatkę. Dostępne w 480p i 720p; żądanie w 1080p z tym polem zostaje odrzucone. Nie wpływa na cenę.

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

camera_fixedbooleanOpcjonalne

Blokuje kamerę, domyślnie false. Ustawione na true trzyma kadr nieruchomo, podczas gdy postać porusza się w jego wnętrzu – idealne do ujęć produktowych i materiałów przeznaczonych na statyczne tło. Zostaw false, kiedy chcesz najazd, panoramę albo odchylenie, i napisz o tym w prompcie.

Domyślnie: false

generate_audiobooleanOpcjonalneWpływa na cenę

Decyduje, czy natywna ścieżka dźwiękowa ma powstać w synchronie z obrazem. Domyślnie włączone i wycenione w wyższym progu; wyłącz je przy niemych pętlach produktowych albo wtedy, gdy dźwięk dochodzi w postprodukcji.

Domyślnie: true

duration_secondsintegerOpcjonalneWpływa na cenę

Długość w pełnych sekundach, od 4 do 12, domyślnie 5, i zarazem rozliczana wielkość. Im dłużej trwa ujęcie, tym bardziej oddala się od klatki źródłowej, więc potwierdź ruch przy 4 albo 5 sekundach, zanim je wydłużysz.

Domyślnie: 5
Ograniczenia: minimum:4
maximum:12

resolutionstringOpcjonalneWpływa na cenę

Rozdzielczość wyjścia, domyślnie 720p, a najwyżej 1080p; nic wyższego nie jest tu oferowane. Wybiera próg cenowy. Pamiętaj, że rządzi wyłącznie dostarczanym formatem – nie uratuje miękkiej klatki źródłowej.

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

aspect_ratiostringOpcjonalne

Kadrowanie wyjścia, sześć sztywnych wartości, domyślnie 16:9. W tej generacji nie ma opcji adaptive, więc niezgodność ze źródłem jest rozwiązywana przez przekadrowanie do żądanych proporcji, a postać może stracić marginesy. Pewną drogą jest dopasowanie się do kadru źródłowego.

Domyślnie: "16:9"
Dozwolone wartości: "21:9""16:9""4:3""1:1""3:4""9:16"

last_image_urlstringOpcjonalne

Opcjonalna klatka końcowa: wysłana razem z `image_url` wymusza, żeby ujęcie doszło do tego kadru, dzięki czemu przejścia i pary przed–po da się powtarzać. Nadaj jej te same proporcje co klatce początkowej. Dostępne w 480p i 720p; żądanie w 1080p z tym polem zostaje odrzucone. Nie wpływa na cenę.

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

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "16:9",
      "description": "Aspect ratio of the generated video.",
      "enum": [
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 60,
        "widget": "select"
      }
    },
    "camera_fixed": {
      "default": false,
      "description": "Lock the camera to produce a stable, fixed-position shot.",
      "type": "boolean",
      "x-ui": {
        "affects_price": false,
        "order": 20,
        "widget": "switch"
      }
    },
    "duration_seconds": {
      "default": 5,
      "description": "Clip length in seconds. This is the billed quantity.",
      "maximum": 12,
      "minimum": 4,
      "type": "integer",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 40,
        "unit": "s",
        "widget": "slider"
      }
    },
    "generate_audio": {
      "default": true,
      "description": "Generate a native soundtrack synchronised to the picture.",
      "type": "boolean",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 30,
        "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": 80,
        "widget": "upload"
      }
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional closing frame the shot has to land on (480p and 720p).",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 75,
        "widget": "upload"
      }
    },
    "prompt": {
      "description": "What to generate: subject, action, camera movement and mood.",
      "minLength": 3,
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 90,
        "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": 50,
        "widget": "radio"
      }
    },
    "seed": {
      "description": "Random seed for controlled comparisons. Omit it to let each run pick its own.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "affects_price": false,
        "order": 10,
        "widget": "number"
      }
    }
  },
  "required": [
    "prompt",
    "image_url"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "variant_matrix",
    "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-1.5-pro/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-1.5-pro/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-1.5-pro/image-to-video \
  --input-json '{"aspect_ratio":"16:9","duration_seconds":5,"generate_audio":true,"image_url":"https://example.com/reference.png","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise","resolution":"720p"}' \
  --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-1.5-pro/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-1.5-pro/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 1.5 Pro · 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-1-5-pro/api?model=bytedance%2Fseedance-1.5-pro%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