Wan 3.0 视频（海外）

接口提示

wan30_video_intl 是 Wan 3.0 All-in-One 标准版模型的海外版本, 使用一个模型 ID 统一支持文生视频、首帧和首尾帧图生视频及参考生视频

wan30_video_intl 最长可生成 30 秒、帧率为 30fps 的视频; Vtrix 不将 input.prompt 或 input.media 校验为必填字段, 但上游模型要求至少提供其中一项

同一请求中, input.media 的参考素材、文件和网页链接类型不能与 first_frame 或 last_frame 混用

认证

authorization `string` 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model `string` 必填

请求使用的模型 ID

值: wan30_video_intl

input `array` 必填

Vtrix generation 请求数组. 模型请求体需要放在 input[0].params 中

input[0].params `object` 必填

Wan 3.0 请求体. 输入内容放在 input 中, 生成选项放在 parameters 中

input object

视频生成请求的输入内容

input.prompt string

描述期望视频的文本提示词. 支持中文和英文, 超出长度的内容会被截断. 在参考生视频模式下, 可按数组顺序使用“图 1”“视频 1”“音频 1”等名称引用素材

最大长度: 20000 个字符

input.media array

首帧、首尾帧、参考素材、文件或网页链接输入. 每个元素包含 type 和 url

first_frame: 最多 1 张图像, 严格作为视频首帧

last_frame: 最多 1 张图像, 严格作为视频尾帧

reference_image: 最多 10 张参考图像

reference_video: 最多 5 段参考视频, 总时长不超过 15 秒

reference_audio: 最多 5 段参考音频, 总时长不超过 15 秒

file: 最多 1 个文档, 不能和 link 同时使用

link: 最多 1 个公开网页, 不能和 file 同时使用

input.media[].type string

媒体素材类型

可选值: first_frame, last_frame, reference_image, reference_video, reference_audio, file, link

input.media[].url string

可公开访问的媒体 URL, 或在支持的场景中使用 Base64 编码图像数据

图像要求: JPEG、JPG、无透明通道的 PNG、BMP 或 WEBP; 单边 240 到 8000 像素; 长宽比不超过 8:1; 文件大小不超过 20MB

参考视频要求: MP4 或 MOV; 每段 1 到 15 秒; 单边 240 到 4096 像素; 长宽比不超过 8:1; 文件大小不超过 100MB

参考音频要求: WAV 或 MP3; 每段 1 到 15 秒; 文件大小不超过 15MB

文件要求: DOCX、DOC、XLSX、XLS、PPTX、PPT、PDF、TXT、KEY、PAGES、NUMBERS 或 MD; 文件大小不超过 100MB; 分页文档最多支持 50 页

parameters object

视频生成选项

parameters.resolution string

输出分辨率档位. 成功任务的实际输出分辨率用于计费

可选值: 1080P, 720P, 480P

默认值: 1080P

parameters.ratio string

输出视频宽高比. adaptive 会根据输入媒体比例和请求意图自动选择比例

可选值: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16

默认值: adaptive

parameters.duration integer

输出视频时长, 单位为秒. 无视频输入时可设置为 2 到 30 的整数. 有视频输入时, 输入视频总时长与输出时长之和不能超过 30 秒. 设置为 -1 时由模型智能选择时长

默认值: 5

parameters.audio boolean

输出视频是否包含音频. 开启或关闭音频不影响价格

可选值: true, false

默认值: true

parameters.seed integer

用于提高生成结果可复现性的随机数种子

范围: 0 - 2147483647

parameters.prompt_extend boolean

是否使用大模型改写并丰富提示词. 对较短提示词通常能提升效果, 但会增加处理时间

可选值: true, false

默认值: true

parameters.watermark boolean

是否在输出视频中添加水印

可选值: true, false

默认值: false

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error `object`

错误信息, 仅在状态为 failed 时存在

code string

错误码

message string

详细错误信息

output `array`

生成结果, 仅在状态为 completed 时存在

content array

生成的资源内容列表

type string

资源类型

值: image｜video

url string

处理后的资源 URL

jobId string

远端任务 ID

usage `object`

使用统计, 仅在状态为 completed 时存在

cost string

总费用（美元）

discount number

折扣金额

metadata `object`

元数据信息

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "model": "wan30_video_intl", "input": [ { "params": { "input": { "prompt": "银色飞船降落在绿色山谷中, 电影感跟拍镜头", "media": [ { "type": "first_frame", "url": "https://example.com/first-frame.png" } ] }, "parameters": { "resolution": "1080P", "ratio": "16:9", "duration": 5, "audio": true, "seed": 12345, "prompt_extend": true, "watermark": false } } } ] }'

{ "id": "d5u5obte8783ap44qtj0", "created_at": 1787889600000, "status": "completed", "model": "wan30_video_intl", "output": [ { "content": [ { "type": "video", "url": "https://example.com/generated-video.mp4", "duration": 5, "jobId": "remote_job_id_12345" } ] } ], "usage": { "cost": "0.000500", "discount": 0, "quantity": 5, "unit_price": "0.000100" } }

Wan 3.0 视频（海外）

接口提示

认证

authorization `string` 必填

参数

model `string` 必填

input `array` 必填

input[0].params `object` 必填

input `object`

input.prompt `string`

input.media `array`

input.media[].type `string`

input.media[].url `string`

parameters `object`

parameters.resolution `string`

parameters.ratio `string`

parameters.duration `integer`

parameters.audio `boolean`

parameters.seed `integer`

parameters.prompt_extend `boolean`

parameters.watermark `boolean`

轮询

响应格式

error `object`

code `string`

message `string`

output `array`

content `array`

type `string`

url `string`

jobId `string`

usage `object`

cost `string`

discount `number`

metadata `object`

接口提示

认证

authorization string 必填

参数

model string 必填

input array 必填

input[0].params object 必填

input object

input.prompt string

input.media array

input.media[].type string

input.media[].url string

parameters object

parameters.resolution string

parameters.ratio string

parameters.duration integer

parameters.audio boolean

parameters.seed integer

parameters.prompt_extend boolean

parameters.watermark boolean

轮询

响应格式

error object

code string

message string

output array

content array

type string

url string

jobId string

usage object

cost string

discount number

metadata object

authorization `string` 必填

model `string` 必填

input `array` 必填

input[0].params `object` 必填

input `object`

input.prompt `string`

input.media `array`

input.media[].type `string`

input.media[].url `string`

parameters `object`

parameters.resolution `string`

parameters.ratio `string`

parameters.duration `integer`

parameters.audio `boolean`

parameters.seed `integer`

parameters.prompt_extend `boolean`

parameters.watermark `boolean`

error `object`

code `string`

message `string`

output `array`

content `array`

type `string`

url `string`

jobId `string`

usage `object`

cost `string`

discount `number`

metadata `object`