Saltar al contenido principal
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \ --url https://api.cometapi.com/volc/v3/contents/generations/tasks \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "doubao-seedance-1-5-pro-251215", "content": [ { "type": "text", "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9" } ] } '
{
  "id": "021773297205999example"
}
Usa este endpoint para iniciar una tarea de video Seedance de ByteDance a partir de texto, o de texto más imágenes de referencia. La solicitud devuelve un id de tarea de inmediato y el renderizado continúa de forma asíncrona.

​
Elige la ruta del modelo actual

  • Usa la página Models para consultar la disponibilidad e identificadores actuales de los modelos.
  • Usa doubao-seedance-1-5-pro-251215 como ejemplo actual de producción para esta ruta.
  • El mismo modelo actual puede manejar tanto solicitudes de solo texto como solicitudes guiadas por imágenes mediante el array content unificado.

​
Flujo de la tarea

1

Construye el array content

Coloca primero la instrucción principal de texto y luego agrega elementos de imagen solo cuando necesites guía para el primer o el último fotograma.
2

Envía la tarea

Guarda el id de tarea devuelto. Si quieres entrega por push, configura callback_url cuando crees la tarea.
3

Haz polling hasta que llegue la salida

Llama a ByteDance Video Query hasta que la tarea finalice y exista un content.video_url.

​
Comportamiento conocido del wrapper

Volcengine y Seedance documentan esta familia como un flujo de trabajo asíncrono de crear y luego consultar. CometAPI mantiene ese mismo patrón de tareas, pero te ofrece una única URL base y una sola API key.
Durante la validación en vivo del 2026-03-12, esta ruta era accesible pero seguía devolviendo un error de análisis JSON del lado del servidor para una muestra JSON estándar. Trata los ejemplos de OpenAPI aquí como la referencia práctica del wrapper y valida tu payload en una fase temprana del desarrollo.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
​
model
string
requerido

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

Ejemplo:

"doubao-seedance-1-5-pro-251215"

​
content
object[]
requerido

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

​
callback_url
string

Optional webhook URL for task status notifications.

Respuesta

200 - application/json

Task accepted.

​
id
string
requerido

Task id for later polling.