开放范围
仅开放图片生成、视频生成和任务查询。文本、音频、文件和模型管理等 DashScope 接口不会从此路径透传。
原生两步流程
① 提交百炼视频任务
POST /dashscope/api/v1/services/aigc/video-generation/video-synthesisDashScope 原生 JSON必填Body 使用百炼原生 model、input 和 parameters。路由时仅把 model 改成所选供给配置的上游模型 ID,其余字段原样提交。
提交百炼图片任务
POST /dashscope/api/v1/services/aigc/text2image/image-synthesisDashScope 原生 JSON必填传统 text2image 端点按百炼要求异步提交,返回 output.task_id 后通过统一任务端点查询。
POST /dashscope/api/v1/services/aigc/multimodal-generation/generationDashScope 原生 JSON必填新版 multimodal-generation 原生端点支持同步响应;如客户端携带 X-DashScope-Async,也会保存任务并支持后续查询。
② 查询百炼任务
GET /dashscope/api/v1/tasks/:id平台任务 id必填使用提交响应中的 output.task_id 查询。视频成功返回 output.video_url;图片成功返回 output.results。首次成功时幂等结算。
默认返回平台任务 ID,用来隐藏上游账号和任务标识;客户组显式启用原厂任务 ID 透传时,也可直接使用百炼 task_id 查询。
计费模型
提交前预留余额:视频按时长和分辨率,图片按张数和尺寸估算。成功才结算,失败释放预留;模型必须已上架且已配置价格或明确免费。
请求与响应体
用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部“调试”拉起在线运行面板。
① 提交百炼视频任务
curl https://zerofa.ai/dashscope/api/v1/services/aigc/video-generation/video-synthesis \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-H "X-DashScope-Async: enable" \
-d '{
"model": "your-dashscope-video-model-id",
"input": { "prompt": "一只白马穿过晨雾" },
"parameters": {
"duration": 5,
"resolution": "1080P",
"ratio": "16:9",
"watermark": false
}
}'
# {"request_id":"...","output":{"task_id":"...","task_status":"PENDING"}}提交百炼图片任务
curl https://zerofa.ai/dashscope/api/v1/services/aigc/text2image/image-synthesis \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-H "X-DashScope-Async: enable" \
-d '{
"model": "your-dashscope-image-model-id",
"input": { "prompt": "一间晨光中的花店" },
"parameters": { "size": "1024*1024", "n": 1 }
}'
# 查询仍使用 GET /dashscope/api/v1/tasks/TASK_ID② 查询百炼任务
curl https://zerofa.ai/dashscope/api/v1/tasks/TASK_ID \
-H "Authorization: Bearer sk-zerofa-xxx"
# {"request_id":"...","output":{"task_id":"...","task_status":"SUCCEEDED","video_url":"https://..."}}