Démarrage rapide API
Créer et suivre une génération image vers vidéo.
1. Configurer les identifiants
export SEEDANCE_BASE_URL="https://api.seedance2video.io/v1"
export SEEDANCE_API_KEY="sd_live_replace_me"Conservez la Key uniquement dans un Secret Manager serveur ou une Credential n8n.
2. Créer une génération
L'hôte d'entrée doit être approuvé au préalable pour l'API Key.
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":"Le sujet se tourne lentement vers la caméra, tandis que le fond reste stable.",
"inputs":[{"type":"image","url":"https://media.example.com/reference.png"}],
"parameters":{"duration_seconds":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}
}'L'API renvoie 202, id, status_url et le coût réel billing.cost_credits, calculé comme sur PC.
3. Suivre la même génération
curl "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
--header "Authorization: Bearer $SEEDANCE_API_KEY"Pour queued ou processing, respectez retry_after_seconds ou Retry-After. À la fin, utilisez output.video_url ou output.image_urls.
Si la création expire, réessayez avec exactement le même corps et Idempotency-Key ; ne créez pas automatiquement une tâche de remplacement avec une nouvelle clé.
Une création acceptée renvoie 202 Accepted. Une réponse terminée conserve ce schéma et la politique same_as_pc :
{
"status": "completed",
"output": {
"urls": ["https://.../completed-video.mp4"],
"video_url": "https://.../completed-video.mp4"
},
"billing": {
"unit": "credits",
"cost_credits": 355,
"policy": "same_as_pc"
}
}La première vidéo se trouve dans output.video_url.