生成视频
提交、查询与下载
- 异步提交并保存任务 ID:POST https://api.apizt.com/alibailian/api/v1/services/aigc/video-generation/video-synthesis,Header 设置 X-DashScope-Async: enable,按本页 input 和 parameters 提交,保存 output.task_id。
- 查询百炼任务:将 output.task_id 填入 GET https://api.apizt.com/alibailian/api/v1/tasks/{task_id};GET 不发送 body,读取 output.task_status。
- 保存视频结果:output.task_status 为 SUCCEEDED 后读取 output.video_url 并及时下载或转存。等待超时后使用同一 task_id 继续查询,不重复创建。
本页 wan2.5-i2v-preview 仍由当前目录收录,保留其已有图生视频参数。Wan 3.0 的多种输入模式需要单独核对,不能只替换 model。
▼
Authorization
在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
请求参数
Header 参数
X-DashScope-Asyncstring必需
示例:enable。Wan 2.5 视频生成使用异步调用。
Header 参数
Content-Type
string
必需
示例: application/json
Authorization
string
必需
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
model
string
必需
模型名称, (必选) 用于指定本次视频生成所用到的模型。示例值:wan2.5-i2v-preview。
input
object
必需
输入信息, (必选) 输入的基本信息,如提示词、图像等。
prompt
string
必需
提示词, (可选) 用来描述生成图像中期望包含的元素和视觉特点。
negative_prompt
string
必需
反向提示词, (可选) 用来描述不希望在视频画面中看到的内容。
img_url
string
必需
首帧图像, (必选) 首帧图像的URL或 Base64 编码数据。
audio_url
string
必需
音频文件URL, (可选,仅wan2.5-i2v-preview支持) 模型将使用该音频生成视频。
template
string
必需
视频特效模板, (可选) 视频特效模板的名称。若未填写,表示不使用任何视频特效。
parameters
object
必需
视频处理参数, (可选) 视频的高级处理参数,如设置分辨率、时长、水印等。
resolution
string
必需
视频分辨率, (可选) 指定生成的视频分辨率档位,不改变视频的宽高比。
duration
integer
必需
视频时长, (可选) 生成视频的时长,单位为秒。该参数的取值依赖于model参数。
prompt_extend
boolean
必需
Prompt智能改写, (可选) 是否开启prompt智能改写。默认值为true。
watermark
boolean
必需
水印标识, (可选) 是否添加“AI生成”水印标识。默认值为false。
audio
boolean
必需
自动添加音频, (可选,仅wan2.5-i2v-preview支持) 控制是否自动为视频添加音频,仅在audio_url为空时生效。
seed
integer
必需
随机数种子, (可选) 固定seed值有助于提升生成结果的可复现性。
示例
{
"model": "wan2.5-i2v-preview",
"input": {
"prompt": "改变一下光线",
"img_url": "https://brainrot-yt-shorts.oss-cn-beijing.aliyuncs.com/images/cached/55a955b7e41723417281051d7bebdb45.png"
},
"parameters": {
"resolution": "480P",
"prompt_extend": true
}
}
请求示例代码
先设置 tokenba_API_KEY;Python 安装 requests,JavaScript 使用 Node.js 20+。示例未进行付费生成实测。
curl --fail-with-body --request POST "https://api.apizt.com/alibailian/api/v1/services/aigc/video-generation/video-synthesis" \
--header "Authorization: Bearer $tokenba_API_KEY" \
--header "X-DashScope-Async: enable" \
--header "Content-Type: application/json" \
--data-raw '{
"model": "wan2.5-i2v-preview",
"input": {
"prompt": "改变一下光线",
"img_url": "https://brainrot-yt-shorts.oss-cn-beijing.aliyuncs.com/images/cached/55a955b7e41723417281051d7bebdb45.png"
},
"parameters": {
"resolution": "480P",
"prompt_extend": true
}
}'import os
import requests
headers = {
"Authorization": f"Bearer {os.environ['tokenba_API_KEY']}",
"X-DashScope-Async": "enable",
}
payload = {'model': 'wan2.5-i2v-preview', 'input': {'prompt': '改变一下光线', 'img_url': 'https://brainrot-yt-shorts.oss-cn-beijing.aliyuncs.com/images/cached/55a955b7e41723417281051d7bebdb45.png'}, 'parameters': {'resolution': '480P', 'prompt_extend': True}}
response = requests.post('https://api.apizt.com/alibailian/api/v1/services/aigc/video-generation/video-synthesis', headers=headers, json=payload, timeout=60)
response.raise_for_status()
print(response.json())(async () => {
const response = await fetch("https://api.apizt.com/alibailian/api/v1/services/aigc/video-generation/video-synthesis", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.tokenba_API_KEY}`,
"X-DashScope-Async": "enable",
"Content-Type": "application/json"
},
body: JSON.stringify({"model": "wan2.5-i2v-preview", "input": {"prompt": "改变一下光线", "img_url": "https://brainrot-yt-shorts.oss-cn-beijing.aliyuncs.com/images/cached/55a955b7e41723417281051d7bebdb45.png"}, "parameters": {"resolution": "480P", "prompt_extend": true}})
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());
})().catch(console.error);返回响应
响应参数 🟢 200 OK · application/json
request_id
string
必需
output
object
必需
task_id
string
必需
task_status
string
必需
异步 Header 与字段参考:阿里云 Wan 首帧图生视频 API。parameters.audio 只适用于官方声明支持的型号,本页 wan2.5-i2v-preview 示例不发送该字段。
当前模型与版本
依据 apizt 价格页,同步于 。以下型号按目录声明的协议与本页用途筛选;不代表所有参数和功能通用。切换前请核对型号说明、令牌分组与参数差异。Gemini 原生接口需同时替换 URL 中的模型 ID。
| 模型 ID | 能力标签 | 支持分组 |
|---|---|---|
wan2.6-i2v | 异步,视频,首帧 | 分组(3)
|
wan2.5-i2v-preview | 异步,视频,首帧 | 分组(3)
|
共列入 2 个候选型号。查看完整模型、版本与接口目录。