跳到主要内容

阿里视频生成

使用阿里百炼 / DashScope 原生格式创建视频生成任务。该端点只用于阿里视频通道,不接受 OpenAI/Sora 的 prompt 顶层请求体。

当前平台对外展示的阿里视频模型为 wan2.7-i2vwan2.6-i2v。下面只列对外可传的阿里百炼 / DashScope 官方请求体字段。

可参考官方的api文档: https://bailian.console.alibabacloud.com/cn-beijing?tab=api#/api/?type=model&url=3025059

Try It

POST/aliyun/v1/videos/generationshttps://api-platform.ope.ai

端点

端点鉴权用途
POST /aliyun/v1/videos/generationsAuthorization: Bearer <api-key>创建阿里百炼视频任务
GET /aliyun/v1/tasks/{task_id}Authorization: Bearer <api-key>查询阿里视频任务状态
GET /aliyun/v1/videos/{task_id}/contentAuthorization: Bearer <api-key>下载阿里视频结果

模型与输入规则

模型必填输入主要参数说明
wan2.7-i2vinput.media
  • parameters.resolution
  • parameters.duration
  • parameters.prompt_extend
  • parameters.watermark
  • parameters.seed
官方新版图生视频协议,参考素材统一放入 media 数组
wan2.6-i2vinput.img_url
  • parameters.resolution
  • parameters.duration
  • parameters.prompt_extend
  • parameters.shot_type
  • parameters.watermark
  • parameters.seed
官方首帧图生视频协议

请求体(application/json)

字段类型必填说明
modelstring阿里百炼视频模型 ID,例如 wan2.7-i2vwan2.6-i2v
inputobject视频输入信息
input.promptstring文本提示词,建议填写
input.negative_promptstring反向提示词
input.mediaarray条件必填wan2.7-i2v 的官方多模态输入,元素包含 typeurl
input.img_urlstring条件必填wan2.6-i2v 的首帧图片 URL
input.audio_urlstring音频 URL,适用于 wan2.6-i2v 中支持音频驱动的场景
parametersobject视频处理参数
parameters.resolutionstring分辨率档位,例如 720P1080P
parameters.durationinteger视频时长,默认按模型规则处理;平台计费会按秒数预估
parameters.prompt_extendboolean是否开启提示词智能改写
parameters.shot_typestring镜头类型,适用于 wan2.6-i2v
parameters.watermarkboolean是否添加水印
parameters.seedinteger随机种子

wan2.7-i2vinput.media[].type 按阿里官方协议使用:first_framelast_framedriving_audiofirst_clip。每个 media 元素必须包含可访问的 url

请求示例

curl -X POST "https://api-platform.ope.ai/aliyun/v1/videos/generations" \
-H "Authorization: Bearer $OPEAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-i2v",
"input": {
"prompt": "一只小猫在草地上奔跑,电影感镜头。",
"media": [
{
"type": "first_frame",
"url": "https://example.com/first-frame.png"
}
]
},
"parameters": {
"resolution": "720P",
"duration": 5,
"prompt_extend": true,
"watermark": false
}
}'

响应示例

创建成功后返回阿里任务结构。保存 output.task_id,用于后续查询和下载。

{
"output": {
"task_status": "PENDING",
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
},
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

错误示例

{
"error": {
"message": "only aliyun channel is supported on /aliyun/v1/videos/generations",
"type": "invalid_request_error",
"param": null,
"code": "invalid_request_error"
}
}