Webhooks (Callback URL)

Reciba notificaciones HTTP POST en tiempo real cuando sus tareas de generación de video se completen, fallen o sean canceladas — en lugar de consultar periódicamente el endpoint de estado de tareas.

Configuración de Callbacks

Incluya una callback_url en su solicitud de generación:

import requests

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "seedance-2.0",
        "prompt": "A sunset over the ocean, cinematic wide shot",
        "quality": "1080p",
        "callback_url": "https://yourapp.com/api/video-callback"
    }
)

Contenido del Callback

Cuando la tarea se completa (o falla), se envía una solicitud POST a su callback_url. El formato del cuerpo de la respuesta es idéntico a la respuesta de la API de consulta de tareas:

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
    }
}

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
    }
}

Momento del Callback

• Se activa cuando la tarea está completada, fallida o cancelada
• Se envía después de que se complete la confirmación de facturación

Requisitos del Callback

Relacionado

• Tareas Asíncronas -- Verificación de estado basada en consultas periódicas
• Códigos de Error -- Referencia de códigos de error