API public

Generează videoclipuri și imagini din propriile tale instrumente

Creează o cheie, apelează API-ul cu autentificare Bearer și verifică statusul sarcinii până când rezultatul tău este gata. Funcționează cu Claude Code, Codex și orice client HTTP.

Gestionează cheile

Ghid rapid

Pas 1

Creează o cheie

Generează o cheie API în dashboard-ul tău. Se afișează o singură dată, așa că păstreaz-o într-un loc sigur.

Pas 2

Apelează API-ul

Trimite o cerere POST cu cheia ta Bearer și un antet Idempotency-Key.

Pas 3

Sondează rezultatul

Interoghează endpoint-ul stării sarcinii până când starea este finalizată sau eșuată, apoi citește rezultatul.

Autentificare

Fiecare cerere este autentificată cu o cheie API Bearer în antetul Authorization.

http

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

Seedance 2 Video

Text, imagine sau media în video.

Trimite un job

POST

/api/v1/video/seedance2

Parametri

Parametru	Tip	Obligatoriu	Implicit	Valori permise
`mode` Generation mode.	`string`	Opțional	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Opțional	`standard`	`ministandardpro`
`channel` Rendering channel.	`string`	Opțional	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Obligatoriu	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Opțional	`16:9`	`1:121:94:33:416:99:16adaptive`
`duration` Clip duration.	`string`	Opțional	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	Opțional	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Opțional	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	Opțional	`—`	`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)`	Opțional	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	Opțional	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Opțional	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	Opțional	`—`	`-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.

Cerere

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"
  }'

Răspuns202

json

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

Valorile credits_used afișate în aceste exemple sunt orientative. Consumul real este calculat la trimitere și returnat de API.

Verifică starea sarcinii

GET

/api/v1/tasks/{id}

Cerere

bash

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

Răspuns200

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

coduri de eroare

All errors share this shape:

json

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

Cod	HTTP	Semnificație
`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.

Utilizare cu Claude Code

Folosește Copy for AI pentru a exporta întregul API ca Markdown curat, lipește-l în Claude Code sau Codex și lasă agentul să conecteze integrarea. Sau direcționează agentul direct către endpoint-ul de text brut.

Deschide llms-api.txt DeepSeek Harness plugin

Skill

Instalează skill-ul Seedance în Claude Code, Codex, sau orice agent — scrie prompt-uri cinematice și le redă prin API pentru tine.

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

Descarcă skill

Întrebări frecvente

Cine poate folosi API-ul?

Oricine are credite. Nu există restricții de abonament — orice cont cu credite poate crea o cheie și poate apela API-ul.

Cum obțin credite?

Încarcă sau abonează-te pe pagina de prețuri. Creditele se adaugă instantaneu în soldul tău.

Creditele sunt partajate între site și API?

Da — soldul tău personal de credite acoperă atât generarea pe web, cât și apelurile API. Într-o echipă, apelurile API folosesc soldul personal al fiecărui membru, nu fondul comun al echipei.

Cum încep?

Creează o cheie API în panoul tău de control, apoi apelează endpoint-urile cu un token Bearer (vezi Quickstart mai sus).

Ce se întâmplă dacă un apel returnează insufficient_credits?

Soldul tău este gol — încarcă pe pagina de prețuri și încearcă din nou.