Tareas Asíncronas

Todas las solicitudes de generación de video se procesan de forma asíncrona. El endpoint de generación devuelve un id de tarea de inmediato. Utilice el endpoint de consulta de tareas para verificar la finalización, o configure una callback_url para notificaciones en tiempo real.

Consultar Estado de Tarea

GET https://api.evolink.ai/v1/tasks/{task_id}

Parámetros de Ruta

Parámetro	Tipo	Requerido	Descripción
`task_id`	string	Sí	El ID de tarea devuelto por el endpoint de generación

Respuesta — Pendiente

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "pending",
    "progress": 0,
    "type": "video",
    "task_info": {
        "can_cancel": true,
        "estimated_time": 165,
        "video_duration": 5
    }
}

Respuesta — Procesando

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "processing",
    "progress": 65,
    "type": "video",
    "task_info": {
        "can_cancel": true
    }
}

Respuesta — Completada

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "completed",
    "progress": 100,
    "results": [
        "https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4"
    ],
    "type": "video",
    "task_info": {
        "can_cancel": false
    }
}

Respuesta — Fallida

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "failed",
    "progress": 0,
    "type": "video",
    "task_info": {
        "can_cancel": false
    }
}

Campos de Respuesta

Campo	Tipo	Descripción
`id`	string	ID de tarea
`object`	string	Tipo de tarea: `video.generation.task`
`created`	integer	Marca de tiempo Unix de creación de la tarea
`model`	string	Modelo utilizado
`status`	string	Estado actual de la tarea (ver abajo)
`progress`	integer	Porcentaje de finalización (0–100)
`results`	array	Array de URLs de video (solo presente cuando está `completed`)
`type`	string	Tipo de salida (`video`)
`task_info.can_cancel`	boolean	Si la tarea aún puede ser cancelada

Valores de Estado

Estado	Descripción
`pending`	Tarea en cola, esperando para iniciar
`processing`	El video se está generando
`completed`	Video listo — consulte el array `results` para las URLs
`failed`	La generación falló

Mejores Prácticas de Consulta

Consulte cada 5 segundos para un equilibrio óptimo
El tiempo típico de generación varía según la duración y la configuración de calidad
Para uso en producción, prefiera Webhooks mediante callback_url en lugar de consultas periódicas
Las URLs de video son válidas durante 24 horas — descárguelas y guárdelas de inmediato

Relacionado

Webhooks -- Notificaciones de finalización en tiempo real mediante callback_url
Códigos de Error -- Gestione escenarios de fallo