返回模型调用 API 参考POST/api/v3/contents/generations/tasks
豆包原生格式:入口与兼容范围
用豆包官方的 content 数组和参数名称调用青云TOP API。本站提供创建任务与单任务查询,适合首尾帧、多模态参考和样片转正式视频。
原生格式是什么
火山方舟官方创建接口为 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 中的 text | prompt | input 的文本 |
| content 中的图/视频/音频 | metadata.content | 图片可用 input_image;其他角色和素材用 metadata.content |
| duration | seconds(正整数)或 metadata.duration(-1) | seconds 或 duration;建议正整数,-1 放 metadata.duration |
| resolution / ratio | metadata.resolution / metadata.ratio | metadata.resolution / metadata.ratio |
| id | id | id 是 resp_…;metadata.task_id 才是视频任务 ID |
| succeeded | completed | completed |
当前开放范围
本目录原生格式提供创建任务与单任务查询,不提供任务列表、批量搜索、取消或删除。请在业务端保存每次创建的 ID,逐个查询,或查看控制台任务日志。请使用完整 /doubao/api/v3/... 路径,勿使用旧 /volc/v1 或省略 /doubao 前缀。
模型能力与时长表、创建参数与各场景示例、查询状态与排错。
参考:火山官方创建文档与查询文档。通过本站调用时,请按本页地址、字段与鉴权方式填写。
Request
请求
/api/v3/contents/generations/tasks