Openbare API

Genereer video's en afbeeldingen met je eigen tools

Maak een sleutel aan, roep de API aan met Bearer-authenticatie en poll de taakstatus totdat je resultaat klaar is. Werkt met Claude Code, Codex en elke HTTP-client.

Beheer sleutels

Snel aan de slag

Stap 1

Sleutel aanmaken

Genereer een API-sleutel in je dashboard. Deze wordt slechts één keer getoond, dus bewaar hem op een veilige plek.

Stap 2

API aanroepen

Stuur een POST-verzoek met je Bearer key en een Idempotency-Key-header.

Stap 3

Resultaat opvragen

Bevraag het taakstatus-eindpunt totdat de status 'voltooid' of 'mislukt' is, en lees dan de uitvoer.

Authenticatie

Elk verzoek wordt geauthenticeerd met een Bearer API-sleutel in de Authorization-header.

http

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

Seedance 2 Video

Tekst, afbeelding of media naar video.

Taak indienen

POST

/api/v1/video/seedance2

Parameters

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

Verzoek

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

Antwoord202

json

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

De credits_used-waarden in deze voorbeelden zijn ter illustratie. Het werkelijke verbruik wordt bij het indienen berekend en door de API geretourneerd.

Taakstatus controleren

GET

/api/v1/tasks/{id}

Verzoek

bash

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

Antwoord200

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

Foutcodes

All errors share this shape:

json

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

Code	HTTP	Betekenis
`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.

Gebruik met Claude Code

Gebruik Copy for AI om de volledige API als nette Markdown te exporteren, plak deze in Claude Code of Codex en laat de agent de integratie opzetten. Of wijs de agent direct naar het raw-text-endpoint.

Open llms-api.txt DeepSeek Harness plugin

Skill

Installeer de Seedance-skill in Claude Code, Codex of een andere agent — hij schrijft filmische prompts en rendert ze voor je via de API.

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

Skill downloaden

Veelgestelde vragen

Wie kan de API gebruiken?

Iedereen met credits. Er is geen planbeperking — elk account met credits kan een sleutel aanmaken en de API aanroepen.

Hoe krijg ik credits?

Waardeer op of abonneer je op de prijzenpagina. Credits worden direct aan je saldo toegevoegd.

Worden credits gedeeld tussen de website en de API?

Ja — je persoonlijke creditsaldo wordt gebruikt voor zowel webgeneratie als API-aanroepen. In een team gebruiken API-aanroepen het eigen persoonlijke creditsaldo van elk lid, niet de gedeelde teampool.

Hoe begin ik?

Maak een API-sleutel aan in je dashboard en roep de endpoints aan met een Bearer-token (zie Quickstart hierboven).

Wat als een call insufficient_credits retourneert?

Je saldo is leeg — laad op via de prijzenpagina en probeer het opnieuw.