Wan3.0 视频生成

• 阿里云万相 3.0 全能参考视频模型（统一入口）
• 文生视频 / 首帧 / 首尾帧 / 参考生视频 / 参考文件生视频
• 分辨率 480P / 720P / 1080P，时长 2–30 秒，或 -1 由模型决定
• 支持图、视频、音频、文档、网页等多模态参考

请求示例

bash curl --request POST \ --url https://api.openveer.com/v1/videos/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "wan3.0-video", "prompt": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。", "resolution": "720P", "size": "16:9", "duration": 5 }'

```python
import requests

url = "https://api.openveer.com/v1/videos/generations"

payload = {
"model": "wan3.0-video",
"prompt": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。",
"resolution": "720P",
"size": "16:9",
"duration": 5,
}

headers = {
"Authorization": "Bearer ",
"Content-Type": "application/json",
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = "https://api.openveer.com/v1/videos/generations";

const payload = {
model: "wan3.0-video",
prompt: "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。",
resolution: "720P",
size: "16:9",
duration: 5,
};

const headers = {
Authorization: "Bearer ",
"Content-Type": "application/json",
};

fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload),
})
.then((response) => response.json())
.then((data) => console.log(data))
.catch((error) => console.error("Error:", error));
```

```go
package main

import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)

func main() {
url := "https://api.openveer.com/v1/videos/generations"

  payload := map[string]interface{}{
      "model":      "wan3.0-video",
      "prompt":     "一只小猫在月光下的屋顶上奔跑",
      "resolution": "720P",
      "size":       "16:9",
      "duration":   5,
  }

  jsonData, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Set("Authorization", "Bearer <token>")
  req.Header.Set("Content-Type", "application/json")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
      panic(err)
  }
  defer resp.Body.Close()

  body, _ := ioutil.ReadAll(resp.Body)
  fmt.Println(string(body))

}
```

响应示例

json { "code": 200, "data": [ { "status": "submitted", "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ" } ] }

json { "error": { "code": 400, "message": "请求参数无效", "type": "invalid_request_error" } }

json { "error": { "code": 401, "message": "身份验证失败，请检查您的API密钥", "type": "authentication_error" } }

json { "error": { "code": 402, "message": "账户余额不足，请充值后再试", "type": "payment_required" } }

json { "error": { "code": 429, "message": "请求过于频繁，请稍后再试", "type": "rate_limit_error" } }

认证

生成模式

模型名固定 wan3.0-video，按传参自动承接多种能力：

请求参数

基础

素材输入

两族素材互斥

素材分两族，不能混用（提交前校验，返回 400，不建任务、不扣费）：

裸 image_urls 如何归属

1. 传了 generation_type → 以它为准（frame / reference）
2. 未传，但请求含参考族输入（video_urls / audio_urls / audio_url / file_url / link_url）→ 归 reference_image
3. 都没有 → 归首尾帧族：第 1 张 first_frame，第 2 张 last_frame（与 wan2.7 一致）

需要精确控制时请用 image_with_roles。

素材上限与格式

请求示例

文生视频

{
  "model": "wan3.0-video",
  "prompt": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。",
  "resolution": "720P",
  "size": "16:9",
  "duration": 5
}

首帧生视频

{
  "model": "wan3.0-video",
  "prompt": "画面中的人物开始说唱，镜头缓缓推进",
  "image_urls": ["https://example.com/first.png"],
  "resolution": "720P",
  "duration": 5
}

首尾帧生视频

{
  "model": "wan3.0-video",
  "prompt": "从微笑逐渐变为大笑，背景光线从冷色调渐变为暖色调",
  "image_urls": [
    "https://example.com/first.png",
    "https://example.com/last.jpg"
  ],
  "duration": 5
}

或使用 image_with_roles：

{
  "model": "wan3.0-video",
  "prompt": "从微笑逐渐变为大笑",
  "image_with_roles": [
    {"url": "https://example.com/first.png", "role": "first_frame"},
    {"url": "https://example.com/last.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

参考生视频（多素材）

{
  "model": "wan3.0-video",
  "prompt": "视频1抱着图1，在图3的椅子上弹奏一支舒缓的乡村民谣，并说道：\"今天的阳光真好。\"",
  "generation_type": "reference",
  "image_urls": [
    "https://example.com/object1.jpg",
    "https://example.com/object2.png",
    "https://example.com/chair.png"
  ],
  "video_urls": ["https://example.com/role.mp4"],
  "resolution": "480P",
  "duration": 5
}

有 video_urls 时，裸 image_urls 会自动归参考图；显式 generation_type: "reference" 更清晰。

参考文件生视频

可不传 prompt，由文档内容驱动生成：

{
  "model": "wan3.0-video",
  "file_url": "https://example.com/glass.pptx",
  "resolution": "480P",
  "duration": 10
}

参考网页生视频

{
  "model": "wan3.0-video",
  "prompt": "把这篇文章做成一支科普短片",
  "link_url": "https://example.com/article/123",
  "duration": 15
}

计费

按秒 × 分辨率计费（与官方刊例一致），开关声音同价：

• 默认 1080P（最贵），成本敏感请显式传 480P / 720P
• 计费秒数：传 2–30 时按请求的 duration；传 -1 时按模型实际产出秒数
• audio: true/false 不影响价格

限制与注意

常见错误

均为同步 400，不建任务、不扣费：

Response