Saltar al contenido principal
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
Usa este endpoint después de crear una tarea de ByteDance Jimeng. No inicia un renderizado. Solo informa el estado actual de la tarea y, cuando el trabajo finaliza, la URL del video generado y los metadatos de salida.

Observa estos campos

  • status para el estado actual del proveedor
  • content.video_url cuando el renderizado haya terminado
  • resolution, duration, ratio y framespersecond si tu aplicación necesita metadatos de salida

Bucle de sondeo

1

Primero crea una tarea

2

Consulta por id de tarea

Sigue llamando a este endpoint hasta que el estado alcance un estado terminal.
3

Guarda el resultado

Cuando aparezca content.video_url, copia el resultado a tu propio almacenamiento si necesitas conservación a largo plazo.

URLs de resultados

El flujo de trabajo de ByteDance sigue siendo primero crear y luego consultar por id de tarea. CometAPI mantiene esa estructura y normaliza la autenticación. Trata la URL de video devuelta como una URL de entrega, no como almacenamiento permanente.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Parámetros de ruta

id
string
requerido

Task id returned by the create endpoint.

Respuesta

200 - application/json

Current task state.

id
string
requerido
model
string
requerido
status
string
requerido

Provider task status.

created_at
integer
requerido
updated_at
integer
requerido
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer