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 Video

Tekst, afbeelding of media naar video.

POST

/api/v1/video/seedance

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`	`standardpro`
`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:16`
`duration` Clip duration.	`string`	Optioneel	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	Optioneel	`720p`	`720p1080p`
`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.	`string[] (URL)`	Optioneel	`—`	`≤ 12 public https 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.	`integer`	Optioneel	`—`	`-1 – 4294967295`

Taak indienen

bash

curl -X POST https://seedance2ai.io/api/v1/video/seedance \
  -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"
  }'

GPT Image 2

Nauwkeurige beeldgeneratie.

POST

/api/v1/image/gpt-image-2

Parameters

Parameter	Type	Verplicht	Standaard	Toegestane waarden
`type` Generation type.	`string`	Verplicht	`—`	`text-to-imageimage-to-image`
`channel` Generation channel. economy is lower-cost with polling-based delivery.	`string`	Optioneel	`standard`	`standardeconomy`
`prompt` Text prompt.	`string`	Verplicht	`—`	`3–20000 chars`
`resolution` Output resolution. auto only supports 1K; 1:1 cannot use 4K on the standard channel.	`string`	Verplicht	`—`	`1K2K4K`
`aspectRatio` Aspect ratio.	`string`	Verplicht	`—`	`auto1:15:49:1621:916:94:33:24:53:42:32:11:23:11:39:21`
`batchCount` Number of images.	`integer`	Optioneel	`1`	`1–4`
`imageUrls` Required for image-to-image.	`string[] (URL)`	Optioneel	`—`	`1–10 public https URLs`

Taak indienen

bash

curl -X POST https://seedance2ai.io/api/v1/image/gpt-image-2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-gpt-image-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "Editorial product photo of a transparent running shoe on chrome",
    "resolution": "1K",
    "aspectRatio": "1:1"
  }'

Nano Banana Pro

Gestileerde, premium beeldoutput.

POST

/api/v1/image/nano-banana-pro

Parameters

Parameter	Type	Verplicht	Standaard	Toegestane waarden
`type` Generation type.	`string`	Verplicht	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	Verplicht	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	Optioneel	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	Optioneel	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	Optioneel	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	Optioneel	`—`	`1–8 public https URLs`

Taak indienen

bash

curl -X POST https://seedance2ai.io/api/v1/image/nano-banana-pro \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-nbp-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "A premium packaging mockup for an AI video studio",
    "image_size": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'

Taakstatus controleren

Poll tot de status voltooid of mislukt is.

bash

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

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance",
  "output": { "video_url": "https://..." },
  "credits_used": 30
}

Foutcodes

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 for this account.
`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.

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

# Clone into Claude Code's skills folder
git clone https://github.com/tkaptop/seedance-skill ~/.claude/skills/seedance

Bekijk op GitHub

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

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.