非同期タスク

すべてのビデオ生成リクエストは非同期で処理されます。生成エンドポイントはタスク id を即座に返します。タスク照会エンドポイントを使用して完了をポーリングするか、callback_url を設定してリアルタイム通知を受け取ることができます。

タスクステータスの照会

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

パスパラメータ

パラメータ	型	必須	説明
`task_id`	string	はい	生成エンドポイントから返されたタスク ID

レスポンス — 待機中

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

レスポンス — 処理中

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

レスポンス — 完了

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

レスポンスフィールド

フィールド	型	説明
`id`	string	タスク ID
`object`	string	タスクタイプ: `video.generation.task`
`created`	integer	タスク作成時の Unix タイムスタンプ
`model`	string	使用されたモデル
`status`	string	現在のタスクステータス（下記参照）
`progress`	integer	完了パーセンテージ（0～100）
`results`	array	ビデオ URL の配列（`completed` 時のみ存在）
`type`	string	出力タイプ（`video`）
`task_info.can_cancel`	boolean	タスクをまだキャンセルできるかどうか

ステータス値

ステータス	説明
`pending`	タスクがキューに入り、開始待ちです
`processing`	ビデオを生成中です
`completed`	ビデオが完成しました — `results` 配列で URL を確認してください
`failed`	生成に失敗しました

ポーリングのベストプラクティス

最適なバランスのために 5 秒ごとにポーリングしてください
一般的な生成時間は、長さと画質の設定によって異なります
本番環境では、ポーリングよりも callback_url による Webhooks の使用を推奨します
ビデオ URL の有効期限は 24 時間です — お早めにダウンロードして保存してください