Inicio rápido de la API
Crea y consulta una generación de imagen a vídeo.
1. Configura las credenciales
export SEEDANCE_BASE_URL="https://api.seedance2video.io/v1"
export SEEDANCE_API_KEY="sd_live_replace_me"Guarda la Key solo en un gestor de secretos del servidor o Credential de n8n.
2. Crea una generación
El host de entrada debe estar aprobado previamente para la 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":"El sujeto gira lentamente hacia la cámara y el fondo permanece estable.",
"inputs":[{"type":"image","url":"https://media.example.com/reference.png"}],
"parameters":{"duration_seconds":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}
}'La API devuelve 202, el id, status_url y el coste real en billing.cost_credits, calculado igual que en PC.
3. Consulta la misma generación
curl "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
--header "Authorization: Bearer $SEEDANCE_API_KEY"Mientras el estado sea queued o processing, respeta retry_after_seconds o Retry-After. Al terminar, usa output.video_url o output.image_urls.
Si la creación agota el tiempo, reintenta con exactamente el mismo cuerpo e Idempotency-Key; no crees automáticamente otra tarea con una clave nueva.
La creación aceptada devuelve 202 Accepted. Una respuesta completada mantiene este esquema y la política 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"
}
}Lee el primer vídeo en output.video_url.