Generación de video de ByteDance

Usa el endpoint bytedance-video para crear y gestionar tareas de generación de video mediante POST /volc/v3/contents/generations/tasks, con parámetros flexibles.

POST /volc/v3/contents/generations/tasks

cURL

Text to video

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"
    }
  ]
}
'

200

{
  "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.

Show child attributes

callback_url · string

Optional webhook URL for task status notifications.

Respuesta

200 - application/json

Task accepted.

id · string · requerido

Task id for later polling.