API-Schnellstart
Eine Bild-zu-Video-Generierung erstellen und abfragen.
1. Zugangsdaten setzen
export SEEDANCE_BASE_URL="https://api.seedance2video.io/v1"
export SEEDANCE_API_KEY="sd_live_replace_me"Speichern Sie den Key nur in einem serverseitigen Secret Manager oder n8n Credential.
2. Generierung erstellen
Der Eingabehost muss vorab für den API Key freigegeben sein.
curl --request POST "$SEEDANCE_BASE_URL/videos" \
--header "Authorization: Bearer $SEEDANCE_API_KEY" \
--header "Idempotency-Key: order-10086-shot-1" \
--header "Content-Type: application/json" \
--data '{
"model":"seedance-2.0-pro","mode":"image-to-video",
"prompt":"Das Motiv dreht sich langsam zur Kamera, der Hintergrund bleibt stabil.",
"inputs":[{"type":"image","url":"https://media.example.com/reference.png"}],
"parameters":{"duration_seconds":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}
}'Die API antwortet mit 202, id, status_url und den tatsächlichen billing.cost_credits nach PC-Berechnung.
3. Dieselbe Generierung abfragen
curl "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
--header "Authorization: Bearer $SEEDANCE_API_KEY"Bei queued oder processing retry_after_seconds beziehungsweise Retry-After beachten. Danach output.video_url oder output.image_urls verwenden.
Bei Timeout mit exakt demselben Body und Idempotency-Key wiederholen; nicht automatisch eine Ersatzaufgabe mit neuem Key erstellen.
Eine akzeptierte Erstellung liefert 202 Accepted. Eine abgeschlossene Antwort behält dieses Schema und die Richtlinie same_as_pc bei:
{
"status": "completed",
"output": {
"urls": ["https://.../completed-video.mp4"],
"video_url": "https://.../completed-video.mp4"
},
"billing": {
"unit": "credits",
"cost_credits": 355,
"policy": "same_as_pc"
}
}Das erste Video steht in output.video_url.