下载视频结果

下载已完成的视频并正确处理临时地址与文件保存状态。

GET https://enterprise.beefapi.com/v1/videos/{task_id}/content

先确认任务 status: completed,再用原企业 Key 下载。此接口返回文件数据或临时下载地址的重定向,不返回文本模型的 JSON 回答。

curl --fail --location \
  "https://enterprise.beefapi.com/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $BEEFAPI_KEY" \
  -o video.mp4

$VIDEO_ID 是创建返回的真实 ID。--location 跟随重定向,--fail 避免把 HTTP 错误正文当成视频保存。不要使用 --location-trusted 向另一个域名转发 Key。

响应与错误

返回含义和处理
文件响应或 302 重定向保存文件,验证格式与播放
400,任务未完成返回 任务查询 继续等待
404任务不可见、结果已删除或不存在,核对原 ID 和权限
503 video_delivery_pending文件仍在保存,按 Retry-After 再下载同一任务
502 video_delivery_failed已生成但文件保存失败,保留任务 ID 联系支持
其他错误保存状态和错误正文,见 错误排查

文件格式

通常生成 MP4。Seedance 2.5 如果请求 output_format: mov,可能返回 QuickTime 文件,应保存为适当格式并读取实际 Content-Type,不能只改名当作 MP4。

应用应检查响应状态和类型后再把文件标记为可用;不应把错误 JSON、HTML 或零字节文件作为视频交付。

保存与链接有效期

临时签名地址不要直接作为长期素材 URL 或公开永久链接。完成后尽快转存到自己的存储。临时链接过期时可以重新请求认证下载接口,但仅在文件仍然可用的情况下才可能重新取得;不保证过期或已删除的素材能够恢复。

下载失败不代表生成失败或已退款,也不应触发重新创建视频。查询原任务和 用量记录,必要时向支持提供任务 ID。

本页内容