Skip to main content

​
Resumen

Estos endpoints son para equipos que ya usan la forma de tarea Seedance estilo Volc. La autenticación usa tu API key Bearer de TokenLab. El ID devuelto empieza con cgt-; consulta el estado hasta que status sea succeeded, failed, cancelled o expired. El contrato oficial de tareas usa las rutas REST bajo /api/v3/contents/generations/tasks. Los alias Action anteriores se conservan solo para integraciones antiguas de TokenLab y no forman parte del contrato oficial compatible a nivel de protocolo. callback_url acepta una dirección HTTP(S) pública. TokenLab envía exactamente el objeto de consulta en cada cambio a queued, running, succeeded, failed o expired, sin headers privados de TokenLab. succeeded y failed se reintentan hasta tres veces tras cinco segundos.
Para recuperarte de forma segura tras una desconexión, envía un Idempotency-Key único en la creación REST. Repetir el mismo body con la misma clave devuelve el mismo ID cgt-...; usar esa clave con otro body devuelve 409. No se aplica a la ruta Action antigua.
Ver también Modelos de video Seedance 2.0 y Generación de video.

​
Reglas de contenido

  • Usa type=text para el texto del prompt.
  • type=image_url sin role se trata como el primer frame; también puedes indicar role=first_frame.
  • Usa role=last_frame solo junto con un primer frame.
  • Usa role=reference_image, reference_video o reference_audio para medios de referencia.
  • No mezcles entradas de primer/último frame con medios de referencia en una misma solicitud.

​
Notas de parámetros

  • ratio acepta 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive.
  • El valor predeterminado oficial de generate_audio es false; usa true cuando necesites audio sincronizado.
  • service_tier=default se acepta. Las tareas compatibles con Seedance 2.0 rechazan service_tier=flex, frames y camera_fixed=true.
  • Cuando el modelo seleccionado lo admita, tools puede incluir objetos como { "type": "web_search" }. Las entradas tool mal formadas se rechazan en vez de ignorarse.

​
Ejemplo