异步任务

所有视频生成请求均以异步方式处理。生成接口会立即返回一个任务 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 秒 轮询一次，以达到最佳平衡
实际生成时间因时长和画质设置而异
生产环境中，建议优先使用 Webhooks 的 callback_url，而非轮询
视频 URL 有效期为 24 小时 — 请及时下载保存