外观
Wan
Wan 2.6 视频模型,适合创意场景与结构化镜头提示。
API 接口
| 操作 | 端点 | 模式 |
|---|---|---|
| 视频生成任务 | POST /v1/async/videos/generations | 仅异步 |
模型
| 模型 id | 说明 |
|---|---|
wan2.6 | 文生视频 / 图生视频。seconds 仅 5 / 10 / 15。默认 1080p。 |
wan2.6-flash | 须图生或参考视频(image 或 providerOptions.metadata.reference_urls)。默认 1080p,默认有声。 |
价格
按 n × seconds × 单价(resolution) 计费。
| 模型 | 720p | 1080p |
|---|---|---|
wan2.6-flash | 5/秒 | 8/秒 |
wan2.6 | 9/秒 | 15/秒 |
请求字段
通用字段放在请求体一级,下面列出的模型专用参数放进 providerOptions。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | wan2.6, wan2.6-flash |
prompt | string | 是 | 1–1,500 字符,描述运动、镜头和对白。 |
seconds | integer | 是 | 5、10、15;参考素材模式仅 5 或 10。 |
resolution | string | 否 | 720p / 1080p. Pixapi 默认:1080p。 |
n | integer | 否 | 默认 1,只支持整数 1。 |
image | string / string[] | 否 | 一张公网首帧图 URL,JPEG/PNG/WebP/BMP;Flash 必须传首帧或 metadata.reference_urls,两种模式不能混用。 |
providerOptions | object | 否 | 模型专用选项,详见下表。 |
providerOptions
本表所有字段都写在 providerOptions 内,不要与 model 并列。
| 字段 | 类型 | 说明 |
|---|---|---|
aspect_ratio | string | 16:9, 9:16, 1:1, 4:3, 3:4. 默认 16:9;图生视频按输入图比例。 |
negative_prompt | string | 描述不希望出现的内容,最多 500 字符。 |
seed | integer | 随机种子 0–2147483647;省略时随机。相同种子不保证输出完全一致。 |
prompt_extend | boolean | 是否优化和扩展提示词,默认 true。 |
watermark | boolean | 是否添加 AI 可见水印,默认 false。 |
audio | boolean | 默认有声;仅 wan2.6-flash 可传 false,wan2.6 不接受无声输出。 |
audio_url | string | 同步音频的公网 WAV/MP3 URL,建议时长不少于视频,超出会截取;参考素材模式不支持。 |
shot_type | string | single(默认)或 multi;文字/首帧模式需 prompt_extend=true 才生效。 |
metadata | object | 只允许 reference_urls:1–5 个公网图像/视频 URL,视频(MP4/MOV)最多 3 个。不与 image、audio_url、prompt_extend 同传,seconds 只能为 5 或 10;提示词按顺序用 character1、character2 引用。 |
示例
bash
curl https://api.pixapi.ai/v1/async/videos/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.6",
"prompt": "清晨街道,柔和阳光,镜头缓慢横移",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}'py
import os
import requests
response = requests.post(
"https://api.pixapi.ai/v1/async/videos/generations",
headers={
"Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "wan2.6",
"prompt": "清晨街道,柔和阳光,镜头缓慢横移",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
},
)
response.raise_for_status()
task = response.json()
print(task["id"])js
const response = await fetch('https://api.pixapi.ai/v1/async/videos/generations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "wan2.6",
"prompt": "清晨街道,柔和阳光,镜头缓慢横移",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}),
});
if (!response.ok) {
throw new Error(await response.text());
}
const task = await response.json();
console.log(task.id);go
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{
"model": "wan2.6",
"prompt": "清晨街道,柔和阳光,镜头缓慢横移",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}`)
req, err := http.NewRequest(
"POST",
"https://api.pixapi.ai/v1/async/videos/generations",
bytes.NewBuffer(body),
)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}响应
返回已提交任务。轮询 GET /v1/tasks/{id} 获取结果。
