XRToken API 文档

万相 3.0 请求参数

wan3.0-video / wan3.0-video-prime 在 POST /v1/videos/generations 上的参数标准

API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net

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

  • 国内站创建: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):

模型480P720P1080P
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):

模型480P720P1080P
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 请求体。

字段必填取值
modelwan3.0-videowan3.0-video-prime
contentprompt条件必填input.media 至少填一项
duration整数 230,默认 5。传 -1 为智能时长
resolution480P / 720P / 1080P480p 等同 480P),默认 1080P
ratioadaptive(默认)、16:94:31:13:49:16
generate_audio默认 true。对应上游 audio
seed02147483647
prompt_extend默认 true,智能改写 prompt
watermark默认 false

content 里除文本外,媒体用 type + role

typerole上限
image_urlfirst_frame1
image_urllast_frame1
image_urlreference_image10
video_urlreference_video5,总时长 ≤ 15 秒
audio_urlreference_audio5,总时长 ≤ 15 秒

规则:

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

也可直接传百炼原生结构:input.promptinput.media[].typefirst_frame / last_frame / reference_image / reference_video / reference_audio / file / link)和 parameters

示例

文生视频

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"
}'

首帧生视频

{
  "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" 的图片。

参考生视频

{
  "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。轮询:

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

完整字段表见 创建视频生成任务

On this page