下载视频结果
下载已完成的视频并正确处理临时地址与文件保存状态。
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。
响应与错误
文件格式
通常生成 MP4。Seedance 2.5 如果请求 output_format: mov,可能返回 QuickTime 文件,应保存为适当格式并读取实际 Content-Type,不能只改名当作 MP4。
应用应检查响应状态和类型后再把文件标记为可用;不应把错误 JSON、HTML 或零字节文件作为视频交付。
保存与链接有效期
临时签名地址不要直接作为长期素材 URL 或公开永久链接。完成后尽快转存到自己的存储。临时链接过期时可以重新请求认证下载接口,但仅在文件仍然可用的情况下才可能重新取得;不保证过期或已删除的素材能够恢复。
下载失败不代表生成失败或已退款,也不应触发重新创建视频。查询原任务和 用量记录,必要时向支持提供任务 ID。