原生格式是什么

火山方舟官方创建接口为 POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks,查询为相同路径加 /{id}。在青云上,使用下列入口和青云 API Key:

操作青云完整地址
创建任务POST https://top.qingyuntop.ai/doubao/api/v3/contents/generations/tasks
查询单个任务GET https://top.qingyuntop.ai/doubao/api/v3/contents/generations/tasks/{task_id}
下载成功视频GET https://top.qingyuntop.ai/v1/videos/{task_id}/content

本站豆包格式沿用官方字段,地址增加 /doubao 前缀,创建和查询中的 id 使用本站公共任务 ID。请使用本站地址与 API Key,不要复制厂商域名、厂商 Key 或上游 cgt-… ID。

两步调用

第一步:在每个请求头中填写 Authorization: Bearer YOUR_API_KEY。第二步:调用创建任务,保存返回的 id,然后查询和下载。

与另外两种格式的区别

原生格式把 prompt 放进 content 的 text 项,把 duration、ratio、resolution 等放在请求体顶层;统一和 Responses 则把大多数豆包参数放在 metadata。字段转换表见下:

豆包原生统一视频Responses
content 中的 textpromptinput 的文本
content 中的图/视频/音频metadata.content图片可用 input_image;其他角色和素材用 metadata.content
durationseconds(正整数)或 metadata.duration(-1)seconds 或 duration;建议正整数,-1 放 metadata.duration
resolution / ratiometadata.resolution / metadata.ratiometadata.resolution / metadata.ratio
ididid 是 resp_…;metadata.task_id 才是视频任务 ID
succeededcompletedcompleted

当前开放范围

本目录原生格式提供创建任务与单任务查询,不提供任务列表、批量搜索、取消或删除。请在业务端保存每次创建的 ID,逐个查询,或查看控制台任务日志。请使用完整 /doubao/api/v3/... 路径,勿使用旧 /volc/v1 或省略 /doubao 前缀。

模型能力与时长表、创建参数与各场景示例、查询状态与排错。

参考:火山官方创建文档与查询文档。通过本站调用时,请按本页地址、字段与鉴权方式填写。