DashScope(阿里百炼)系视频模型走百炼原生协议,平台透明转发:请求体 {model, input, parameters}、任务响应与状态枚举均与百炼官方一致。可用模型(如 wan2.6-t2v、happyhorse-1.0 等)以 列出模型 返回为准(protocols 含 dashscope)。
Authorizations
Authorizationstring必填
Bearer Token 认证,无需阿里云 AK。 获取 API Key:访问 API Key 管理页面
Authorization: Bearer YOUR_API_KEY提交生成任务
两个提交端点(按模型选择,与百炼官方一致):
POST /api/v1/services/aigc/video-generation/video-synthesis # 文生视频POST /api/v1/services/aigc/image2video/video-synthesis # 图生视频请求头
| Header | 必选 | 说明 |
|---|---|---|
Authorization |
是 | Bearer YOUR_API_KEY |
Content-Type |
是 | application/json |
X-DashScope-Async |
是 | 必须设为 enable。百炼官方语义:HTTP 只支持异步调用,缺失该头会报错 current user api does not support synchronous calls |
请求体为百炼原生格式:
model(必填)input:prompt、img_url(图生视频首帧)等,按模型支持parameters:size/duration/seed等,按模型支持,以百炼官方文档为准
查询任务
GET /api/v1/tasks/{task_id}output.task_status 枚举(百炼原生):PENDING / RUNNING / SUCCEEDED / FAILED / CANCELED。成功后结果在 output 中(如 video_url),URL 有效期以百炼为准,请及时转存。查询 / 取消接口只需 Authorization 头。
取消任务
POST /api/v1/tasks/{task_id}/cancel仅 PENDING 状态的任务可取消(百炼语义)。
注意事项
- 任务查询 / 取消必须使用提交时所用的同一个 API Key;任务 Id 可查询窗口 7 天,过期返回 404
task_not_found - 建议 5–10 秒轮询一次直到终态(
SUCCEEDED/FAILED/CANCELED) - 白名单外的 service/action 组合返回 404
unsupported_endpoint - 各模型的
input/parameters字段以阿里百炼官方文档为准,平台不做字段改写