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`
`end_image_url` Optional end frame.	`string (URL)`	Optioneel	`—`	`public https URL`
`media_urls` Required for media-to-video. 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` Not supported on the real channel or mini tier.	`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://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
}

Taakstatus controleren

GET

/api/v1/tasks/{id}

Verzoek

bash

curl https://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",
  "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.
`insufficient_credits`	`402`	Not enough credits on the balance.
`rate_limited`	`429`	Too many requests — limit is 30 requests per 60 seconds per account. 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

Klik op Kopiëren zodat AI de volledige API als schone Markdown vastpakt, plak het in Claude Code of Codex en laat het de integratie opzetten. Of wijs de agent direct naar het raw text-eindpunt.

Open llms.txt

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 -L https://seedance2ai.io/downloads/seedance-skill.md -o ~/.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 tegoed 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.