Webhooks（コールバック URL）

タスクステータスエンドポイントをポーリングする代わりに、ビデオ生成タスクが完了、失敗、またはキャンセルされた際にリアルタイムの HTTP POST 通知を受け取ることができます。

コールバックの設定

生成リクエストに callback_url を含めてください。

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

コールバックペイロード

タスクが完了（または失敗）すると、callback_url に POST リクエストが送信されます。レスポンスボディのフォーマットはタスク照会 API のレスポンスと同一です。

完了

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

失敗

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

コールバックのタイミング

• タスクが完了、失敗、またはキャンセルされた時にトリガーされます
• 課金確認が完了した後に送信されます

コールバックの要件

関連ドキュメント

• 非同期タスク — ポーリングベースのステータス確認
• エラーコード — エラーコードリファレンス