label llms.txt open_chatgpt

Seedance 2.0 Mini API Dokumentation

Vollständiger Leitfaden zur Integration der Seedance 2.0 Mini Videogenerierungs-API in Ihre Anwendungen.

API v1 · 2.0 Mini Base URL: https://seedanceapi.org/v1

Schnellstart

bash
1curl -X POST 'https://seedanceapi.org/v1/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6 "aspect_ratio": "16:9",
7 "resolution": "720p",
8 "duration": "8"
9 }'

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem Bearer-Token im Authorization-Header.

Wichtig: Sie können Ihren API-Schlüssel von der API-Keys-Seite in Ihrem Dashboard erhalten. → API-Schlüssel erhalten

http
1Authorization: Bearer YOUR_API_KEY

Preise

480p

480p Auflösung

14,25 Credits pro Ausgabesekunde, pro Anfrage aufgerundet

DauerCredits
4s57 credits
5s72 credits
8s114 credits
10s143 credits
12s171 credits
15s214 credits
720p

720p Auflösung

30,75 Credits pro Ausgabesekunde, pro Anfrage aufgerundet

DauerCredits
4s123 credits
5s154 credits
8s246 credits
10s308 credits
12s369 credits
15s462 credits

API-Endpunkte

POST/v1/generate

Neue Videoerstellungs-Aufgabe mit dem Seedance 2.0 Mini Modell erstellen. Unterstützt Text-zu-Video und Bild-zu-Video.

Anfragekörper

Body ParametersJSON
prompt:string

Textbeschreibung des zu erstellenden Videos (max. 2000 Zeichen)

aspect_ratio:optional string

Seitenverhältnis. Unterstützt: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.

resolution:optional string

Videoauflösung: 480p oder 720p Defaults to 720p.

duration:optional string

Videodauer in Sekunden: Ganzzahl 4–15 Defaults to 8.

generate_audio:optional boolean

AI-Audiogenerierung aktivieren (kein Einfluss auf den Preis) Defaults to false.

fixed_lens:optional boolean

Veraltet — aus Kompatibilität akzeptiert, von Seedance 2.0 Mini ignoriert Defaults to false.

image_urls:optional string[]

Array von Referenzbild-URLs für Bild-zu-Video (max. 1)

callback_url:optional string

Webhook-URL für asynchrone Statusbenachrichtigungen. Muss öffentlich erreichbar sein.

Text zu Video

json
1{
2 "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3 "aspect_ratio": "16:9",
4 "resolution": "720p",
5 "duration": "8"
6}

Bild zu Video

json
1{
2 "prompt": "The character slowly turns and smiles at the camera",
3 "image_urls": [
4 "https://example.com/my-image.jpg"
5 ],
6 "aspect_ratio": "16:9",
7 "resolution": "720p",
8 "duration": "4"
9}

Mit Audiogenerierung

json
1{
2 "prompt": "A peaceful river flowing through a forest with birds singing",
3 "aspect_ratio": "16:9",
4 "resolution": "720p",
5 "duration": "8",
6 "generate_audio": true
7}

Antworten

Task created successfully

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90abc123def456_seedance",
6 "status": "IN_PROGRESS"
7 }
8}
GET/v1/status

Status einer Videoerstellungs-Aufgabe prüfen und Ergebnis nach Abschluss abrufen.

Abfrageparameter

Body ParametersJSON
task_id:string

Die eindeutige Aufgaben-ID vom Generate-Endpunkt

Beispielanfrage

bash
1curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: Das response-Feld in der Status-API ist ein Array von Video-URLs. Sie können direkt auf data.response[0] zugreifen.

javascript
1// Extract video URL from response
2const videoUrl = data.response[0];

Antworten

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90abc123def456_seedance",
6 "status": "SUCCESS",
7 "consumed_credits": 246,
8 "created_at": "2026-02-07T10:30:00Z",
9 "request": {
10 "prompt": "A majestic eagle soaring through golden sunset clouds",
11 "aspect_ratio": "16:9",
12 "resolution": "720p",
13 "duration": "8"
14 },
15 "response": [
16 "https://cdn.example.com/videos/n90abc123def456_seedance.mp4"
17 ],
18 "error_message": null
19 }
20}

API-Spielplatz

Testen Sie die API direkt in Ihrem Browser. Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel.

API-PlaygroundPOST

Fehlercodes

StatusCodeDescription
400 Ungültige AnfrageINVALID_PROMPTDer Prompt ist ungültig oder leer
400 Ungültige AnfrageINVALID_ASPECT_RATIONicht unterstütztes Seitenverhältnis
400 Ungültige AnfrageINVALID_RESOLUTIONAuflösung muss 480p oder 720p sein
400 Ungültige AnfrageINVALID_DURATIONDauer muss 4, 8 oder 12 Sekunden sein
400 Ungültige AnfrageTOO_MANY_IMAGESMaximal 1 Bild-URL im image_urls-Array erlaubt
401 Nicht autorisiertINVALID_API_KEYAPI-Schlüssel fehlt oder ist ungültig
402 INSUFFICIENT_CREDITSNicht genügend Credits für diesen Vorgang
404 Nicht gefundenTASK_NOT_FOUNDAufgaben-ID nicht gefunden oder gehört nicht zu Ihrem Konto
500 Interner ServerfehlerINTERNAL_ERRORServerfehler, bitte versuchen Sie es später erneut