# 万相 3.0 请求参数

接口与其他视频模型相同：

- 国内站创建：`POST https://api.xrtoken.net/v1/videos/generations`
- 国际站创建：`POST https://api.xrtoken.ai/v1/videos/generations`
- 查询：`GET {同一 host}/v1/videos/generations/{id}`

国内站和国际站均提供 `wan3.0-video`（标准版）和 `wan3.0-video-prime`（高速版，能力对齐标准版）。万相 3.0 是全能参考视频模型：文生、图生（首帧/首尾帧）、参考生（图/视频/音频/文件/网页）走同一套参数。最长 30 秒，输出 30fps。

计费按秒：`费用 = 分辨率单价 × (输入视频秒数 + 输出视频秒数)`。无输入视频时只按输出时长。声音开关价格相同。当前售价为官方原价 7 折。

国内站（CNY）：

| 模型 | 480P | 720P | 1080P |
|---|---|---|---|
| `wan3.0-video` | ¥0.21 / 秒（原价 ¥0.3） | ¥0.42 / 秒（原价 ¥0.6） | ¥0.84 / 秒（原价 ¥1.2） |
| `wan3.0-video-prime` | ¥0.315 / 秒（原价 ¥0.45） | ¥0.63 / 秒（原价 ¥0.9） | ¥1.26 / 秒（原价 ¥1.8） |

国际站（USD，官方人民币价 ÷ 7.15）：

| 模型 | 480P | 720P | 1080P |
|---|---|---|---|
| `wan3.0-video` | $0.0294 / 秒（原价 $0.0420） | $0.0587 / 秒（原价 $0.0839） | $0.1175 / 秒（原价 $0.1678） |
| `wan3.0-video-prime` | $0.0441 / 秒（原价 $0.0629） | $0.0881 / 秒（原价 $0.1259） | $0.1762 / 秒（原价 $0.2517） |

## 参数标准

推荐使用与 Seedance 相同的 `content` 数组。也兼容百炼原生 `input` + `parameters` 请求体。

| 字段 | 必填 | 取值 |
|---|---|---|
| `model` | 是 | `wan3.0-video` 或 `wan3.0-video-prime` |
| `content` 或 `prompt` | 条件必填 | 与 `input.media` 至少填一项 |
| `duration` | 否 | 整数 `2`–`30`，默认 `5`。传 `-1` 为智能时长 |
| `resolution` | 否 | `480P` / `720P` / `1080P`（`480p` 等同 `480P`），默认 `1080P` |
| `ratio` | 否 | `adaptive`（默认）、`16:9`、`4:3`、`1:1`、`3:4`、`9:16` |
| `generate_audio` | 否 | 默认 `true`。对应上游 `audio` |
| `seed` | 否 | `0`–`2147483647` |
| `prompt_extend` | 否 | 默认 `true`，智能改写 prompt |
| `watermark` | 否 | 默认 `false` |

`content` 里除文本外，媒体用 `type` + `role`：

| type | role | 上限 |
|---|---|---|
| `image_url` | `first_frame` | 1 |
| `image_url` | `last_frame` | 1 |
| `image_url` | `reference_image` | 10 |
| `video_url` | `reference_video` | 5，总时长 ≤ 15 秒 |
| `audio_url` | `reference_audio` | 5，总时长 ≤ 15 秒 |

规则：

- 媒体 URL 用公网 `https`，或 `data:{MIME};base64,...`。本模型不使用 `asset://`。
- **文生**、**首尾帧图生**、**参考生** 三选一。`first_frame` / `last_frame` 不得与任何 `reference_*` 同时出现。
- 参考模式下 prompt 可用「图1」「视频1」「音频1」指代 `content` 数组里对应顺序的素材（图和视频分别计数）。
- 有参考视频时：输入视频总时长 + 输出时长不超过 30 秒。
- 不支持 `4k`、`21:9`、`service_tier`。

也可直接传百炼原生结构：`input.prompt`、`input.media[].type`（`first_frame` / `last_frame` / `reference_image` / `reference_video` / `reference_audio` / `file` / `link`）和 `parameters`。

## 示例

### 文生视频

```bash
curl -sS https://api.xrtoken.net/v1/videos/generations \
  -H "Authorization: Bearer $XRT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "content": [
      { "type": "text", "text": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质" }
    ],
    "duration": 5,
    "resolution": "720P",
    "ratio": "16:9"
  }'
```

### 首帧生视频

```json
{
  "model": "wan3.0-video",
  "content": [
    { "type": "text", "text": "角色从墙上活过来，一边 rap 一边摆姿势" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/first.png" },
      "role": "first_frame"
    }
  ],
  "duration": 5,
  "resolution": "480P"
}
```

首尾帧再加一条 `"role": "last_frame"` 的图片。

### 参考生视频

```json
{
  "model": "wan3.0-video-prime",
  "content": [
    { "type": "text", "text": "视频1抱着图1，在图2的椅子上弹奏民谣" },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/role.mp4" },
      "role": "reference_video"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/object.png" },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/chair.png" },
      "role": "reference_image"
    }
  ],
  "duration": 5,
  "resolution": "720P",
  "ratio": "adaptive"
}
```

## 查询

创建成功返回任务 `id`。轮询：

```bash
curl -sS "https://api.xrtoken.net/v1/videos/generations/$TASK_ID" \
  -H "Authorization: Bearer $XRT_API_KEY"
```

状态为 `queued` / `processing` / `succeeded` / `failed`。成功后成片地址在 `content.video_url` 或顶层 `video_url`。

完整字段表见 [创建视频生成任务](/docs/api/createVideoGeneration)。