Öffentliche API

Videos und Bilder mit Ihren eigenen Tools generieren

Erstellen Sie einen Schlüssel, rufen Sie die API mit Bearer-Authentifizierung auf und fragen Sie den Aufgabenstatus ab, bis Ihr Ergebnis bereit ist. Funktioniert mit Claude Code, Codex und jedem HTTP-Client.

Schlüssel verwalten

Schnellstart

Schritt 1

Schlüssel erstellen

Generieren Sie einen API-Key in Ihrem Dashboard. Er wird nur einmal angezeigt, bewahren Sie ihn daher sicher auf.

Schritt 2

API aufrufen

Senden Sie eine POST-Anfrage mit Ihrem Bearer-Schlüssel und einem Idempotency-Key-Header.

Schritt 3

Ergebnis abrufen

Fragen Sie den Task-Status-Endpunkt ab, bis der Status „abgeschlossen“ oder „fehlgeschlagen“ ist, und lesen Sie dann die Ausgabe.

Authentifizierung

Jede Anfrage wird mit einem Bearer-API-Schlüssel im Authorization-Header authentifiziert.

http

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

Seedance Video

Text, Bild oder Medien zu Video.

POST

/api/v1/video/seedance

Parameter

Parameter	Typ	Erforderlich	Standard	Zulässige Werte
`mode` Generation mode.	`string`	Optional	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Optional	`standard`	`standardpro`
`channel` Rendering channel.	`string`	Optional	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Erforderlich	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Optional	`16:9`	`1:121:94:33:416:99:16`
`duration` Clip duration.	`string`	Optional	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	Optional	`720p`	`720p1080p`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Optional	`—`	`public https URL`
`end_image_url` Optional end frame.	`string (URL)`	Optional	`—`	`public https URL`
`media_urls` Required for media-to-video.	`string[] (URL)`	Optional	`—`	`≤ 12 public https URLs`
`generate_audio` Generate an audio track.	`boolean`	Optional	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Optional	`false`	`truefalse`
`seed` Not supported on the real channel.	`integer`	Optional	`—`	`-1 – 4294967295`

Auftrag einreichen

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

Hochwertige Bildgenerierung.

POST

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

Parameter

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

Auftrag einreichen

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

Stilisierte, hochwertige Bildausgabe.

POST

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

Parameter

Parameter	Typ	Erforderlich	Standard	Zulässige Werte
`type` Generation type.	`string`	Erforderlich	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	Erforderlich	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	Optional	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	Optional	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	Optional	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	Optional	`—`	`1–8 public https URLs`

Auftrag einreichen

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

Aufgabenstatus prüfen

Wiederholt abfragen, bis der Status „abgeschlossen“ oder „fehlgeschlagen“ ist.

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
}

Fehlercodes

Code	HTTP	Bedeutung
`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

Installieren Sie die Seedance-Fertigkeit in Claude Code, Codex oder einen beliebigen Agenten – sie schreibt filmreife Prompts und rendert diese automatisch über die API für Sie.

bash

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

Auf GitHub ansehen

Mit Claude Code verwenden

Drücken Sie Copy for AI, um die vollständige API als sauberes Markdown zu erfassen, fügen Sie es in Claude Code oder Codex ein und lassen Sie es die Integration einrichten. Oder weisen Sie den Agenten direkt auf den Rohtext-Endpunkt hin.

llms.txt öffnen

FAQ

Wer kann die API nutzen?

Jeder mit Credits. Es gibt keine Planbeschränkung – jedes Konto mit Credits kann einen Schlüssel erstellen und die API aufrufen.

Wie bekomme ich Credits?

Laden Sie Guthaben auf oder abonnieren Sie auf der Preisseite. Guthaben wird Ihrem Konto sofort gutgeschrieben.

Werden Credits zwischen der Website und der API geteilt?

Ja – Ihr persönliches Guthaben wird sowohl für die Web-Generierung als auch für Ihre API-Aufrufe verwendet. In einem Team verwenden API-Aufrufe das persönliche Guthaben jedes Mitglieds, nicht das gemeinsame Team-Guthaben.

Wie starte ich?

Erstellen Sie einen API-Key in Ihrem Dashboard und rufen Sie dann die Endpoints mit einem Bearer-Token auf (siehe Quickstart oben).

Was passiert, wenn ein Aufruf `insufficient_credits` zurückgibt?

Ihr Guthaben ist leer – laden Sie auf der Preisseite auf und versuchen Sie es erneut.