BeefAPI查询视频任务
读取视频进度、最终错误和可选结果元数据。
GET https://enterprise.beefapi.com/v1/videos/{task_id}
使用提交任务时的企业 Key，通过返回的真实 id 查询。不要把其他请求的 Request ID 填作 task_id。
export VIDEO_ID='YOUR_VIDEO_TASK_ID'
curl --fail-with-body "https://enterprise.beefapi.com/v1/videos/$VIDEO_ID" \
-H "Authorization: Bearer $BEEFAPI_KEY"响应字段
| 字段 | 说明 |
|---|---|
id | 任务 ID |
object | 视频对象通常为 video |
model | 请求对应的模型 |
status | 任务状态，见下表 |
progress | 进度值，仅供显示，不是剩余时间保证 |
created_at / completed_at | 创建/完成时间，Unix 秒；可选字段不一定返回 |
error.code / error.message | 失败时的错误信息 |
metadata | 模型相关结果，可能含 URL、用量或尾帧 |
| 状态 | 处理 |
|---|---|
queued | 等待，约 5 秒后再查 |
in_progress | 继续轮询，不重复提交 |
completed | 调用 下载接口 |
failed | 停止轮询并读取错误，核对结算记录 |
unknown / 未识别 | 保留原响应并核查，不自动判为成功 |
Seedance 成功响应示例（字段和数值仅供说明）：
{
"id":"task_example",
"object":"video",
"model":"seedance-2.0-mini",
"status":"completed",
"progress":100,
"metadata":{"url":"https://example.com/result.mp4","usage":{"completion_tokens":40594,"total_tokens":40594}}
}metadata.last_frame_url 仅在请求及结果支持时出现。用量缺失表示未提供，不能填零。下载和费用仍需分别检查。
轮询策略
设置合理间隔和等待上限。网络错误可适当重试查询，429 时降低频率。达到等待上限后保存任务 ID，之后继续查询；客户端超时不等于任务终止。
404 可能是 ID 错误、任务不存在或无权限，先核对提交的 Key、企业域名和原始响应。费用问题通过 请求用量记录 核对，任务 failed 本身不能代替到账读回。