Publiczne API

Generuj filmy i obrazy z własnych narzędzi

Utwórz klucz, wywołaj API z autoryzacją Bearer i odpytuj o status zadania, aż wynik będzie gotowy. Działa z Claude Code, Codex i dowolnym klientem HTTP.

Zarządzaj kluczami

Szybki start

Krok 1

Utwórz klucz

Wygeneruj klucz API w swoim panelu. Jest wyświetlany tylko raz, więc przechowaj go w bezpiecznym miejscu.

Krok 2

Wywołaj API

Wyślij żądanie POST z kluczem Bearer i nagłówkiem Idempotency-Key.

Krok 3

Głosowanie na wynik

Odpytywaj punkt końcowy stanu zadania, aż status zmieni się na „zakończony” lub „nieudany”, a następnie odczytaj wynik.

Uwierzytelnianie

Każde żądanie jest uwierzytelniane za pomocą klucza API typu Bearer w nagłówku Authorization.

http

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Seedance 2 Video

Tekst, obraz lub multimedia na wideo.

Prześlij zadanie

POST

/api/v1/video/seedance2

Parametry

Parametr	Typ	Wymagane	Domyślne	Dozwolone wartości
`mode` Generation mode.	`string`	Opcjonalne	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Opcjonalne	`standard`	`ministandardpro`
`channel` Rendering channel.	`string`	Opcjonalne	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Wymagane	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Opcjonalne	`16:9`	`1:121:94:33:416:99:16adaptive`
`duration` Clip duration.	`string`	Opcjonalne	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	Opcjonalne	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Opcjonalne	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	Opcjonalne	`—`	`public https URL, ≤ 30 MB`
`media_urls` Required for media-to-video. Images are limited to 30 MB; video URLs must support duration probing.	`string[] (URL)`	Opcjonalne	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	Opcjonalne	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Opcjonalne	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	Opcjonalne	`—`	`-1 – 4294967295`

Seedance prompt guide

Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style, and constraints, then map every reference asset to the right API parameter.

Use image_url for the opening frame, end_image_url for the closing frame, and media_urls for character, motion, style, source-video, or extension references.
Describe asset roles in natural language inside prompt. Do not send raw asset ids, asset:// URLs, or in-app-only labels such as @图片1.
For edits say “strictly edit the supplied source video”; for extensions say “continue from the supplied previous clip.”
For complex scenes, use ordered shots plus a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo, and no subtitles unless intended.

Żądanie

bash

curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-video-001" \
  -d '{
    "mode": "text-to-video",
    "quality_tier": "standard",
    "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
    "aspect_ratio": "16:9",
    "duration": "5",
    "resolution": "720p"
  }'

Odpowiedź202

json

{
  "id": "sd2_xxxxx",
  "status": "processing",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30
}

Wartości credits_used pokazane w tych przykładach są orientacyjne. Rzeczywiste zużycie jest obliczane podczas wysyłania i zwracane przez API.

Sprawdź status zadania

GET

/api/v1/tasks/{id}

Żądanie

bash

curl https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

Odpowiedź200

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "resolution": "720p",
  "credits_used": 30,
  "credits_refunded": 0,
  "output": {
    "video_url": "https://...",
    "last_frame_url": "https://...",
    "seed": 123
  },
  "error": null,
  "created_at": "2026-06-03T10:00:00.000Z",
  "updated_at": "2026-06-03T10:03:12.000Z"
}

status: processing · completed · failed

Kody błędów

All errors share this shape:

json

{ "error": { "code": "invalid_request", "message": "Invalid request body" } }

Kod	HTTP	Znaczenie
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`purchase_required`	`403`	Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it.
`insufficient_credits`	`402`	Not enough credits. Seedance 2.5 always returns HTTP 402 with insufficient_credits; when an authoritative quote is available, it may also include required_credits, available_credits, pricing_version, and promotion_applied.
`rate_limited`	`429`	Too many requests — the general limit is 30 requests per 60 seconds per account; Seedance requests that validate reference media are limited to 3 per 60 seconds per account and source IP, with a project-wide safety cap. Retry after the Retry-After response header (in seconds).
`idempotency_conflict`	`409`	Same Idempotency-Key reused with a different body, or still running.
`service_busy`	`503`	Temporary upstream or credit-concurrency issue. Retry.
`not_found`	`404`	Task does not exist or does not belong to this key owner.
`internal_error`	`500`	Unexpected server-side failure.

Użyj z Claude Code

Skorzystaj z funkcji Copy for AI, aby wyeksportować całe API jako czysty Markdown, wklej go do Claude Code lub Codex i pozwól agentowi podpiąć integrację. Możesz też skierować agenta bezpośrednio na surowy endpoint tekstowy.

Otwórz llms-api.txt DeepSeek Harness plugin

Skill

Zainstaluj umiejętność Seedance w Claude Code, Codex lub dowolnym agencie — tworzy kinowe prompty i renderuje je przez API za Ciebie.

bash

# Download the one-file skill from Seedance 2 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

Pobierz skill

FAQ

Kto może korzystać z API?

Każdy, kto ma kredyty. Nie ma ograniczenia planu — każde konto z kredytami może utworzyć klucz i wywołać API.

Jak zdobyć kredyty?

Doładuj lub subskrybuj na stronie z cenami. Kredyty są dodawane do salda natychmiast.

Czy kredyty są współdzielone między stroną internetową a API?

Tak — Twoje osobiste saldo kredytów zasila zarówno generowanie w przeglądarce, jak i wywołania API. W zespole wywołania API korzystają z osobistego salda każdego członka, a nie ze wspólnej puli zespołu.

Jak zacząć?

Utwórz klucz API w swoim panelu, a następnie wywołaj endpointy z tokenem Bearer (zobacz Quickstart powyżej).

Co jeśli wywołanie zwraca insufficient_credits?

Twoje saldo jest puste — doładuj na stronie cennika i spróbuj ponownie.