WAN / 视频生成
Wan 3.0 Prime
wan-3.0-prime
独立的 Wan 型号,按对应规格和授权调用。
- 输出
- 视频
- 分辨率
- 480P / 720P / 1080P
- 输出时长
- 2–30 秒 / 自动(按模式)
- 接入方式
- HTTP / 异步任务
CAPABILITIES
能力与限制
支持模式
文生视频首帧尾帧首尾帧参考素材
使用前需了解
Prime 是独立型号,不能用 Wan 标准版授权或验收替代。自动时长、声音与素材组合以本人模型目录为准。
| 参数 | 支持值 / 默认 |
|---|---|
| 分辨率 | 480P / 720P / 1080P |
| 输出时长 | 2–30 秒 / 自动(按模式) |
| 画幅 | 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive |
| 提示词限制 | 20000 Unicode 码点 |
| 定义默认值(以模式规则为准) | duration: 5 · resolution: 720P · aspect_ratio: adaptive |
| 参考素材上限 | 10 图片 / 5 视频 / 5 音频 |
素材上限不表示所有模式可以组合使用。具体大小、格式与互斥规则见完整字段说明。
查看完整请求字段与限制(中文)↗
| 字段 |
字段含义 | 类型 | 是否必选 | 默认值 | 可选值 / 范围 | 备注说明(模式与素材限制) | 模型专用特殊字段 |
|---|---|---|---|---|---|---|---|
model |
调用型号的接口标识 | string | 是 | 无 | wan-3.0-prime | 固定调用名称,按示例精确填写 | 否 |
prompt |
描述内容、动作、镜头或编辑意图的提示词 | string | 文生是;有素材否 | 有素材可省略 | ≤20000 Unicode码点 | 文生必填;首尾帧或参考素材模式可省略;超长拒绝,不截断 | 否 |
duration |
输出视频时长,单位秒 | integer | 否 | 5 | 2~30秒或-1 | 参考视频输入总时长+固定输出时长≤30秒;-1为自动时长 | 否 |
resolution |
输出视频分辨率 | string | 否 | 720P | 480P / 720P / 1080P | 按本行可选值选择输出分辨率 | 否 |
aspect_ratio |
输出画幅宽高比 | string | 否 | adaptive | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive | 平台统一字段;首尾帧只接受adaptive | 否 |
generate_audio |
是否生成输出视频的声音 | boolean | 否 | true | true / false | 输出是否含声音 | 否 |
image_urls |
图片地址数组 | string[] | 否 | 无 | ≤10张参考图 | 一律作为参考图,单张也不推导为首帧;与reference_image角色合计≤10张;首尾帧使用明确字段,与参考模式互斥 | 否 |
image_with_roles |
明确指定图片用途的数组 | object[] | 否 | 无 | {url,role} | 按角色选择首尾帧或参考;两类互斥,不重复首尾角色 | 否 |
image_with_roles[].url |
数组内单张图片的地址 | string | 数组内是 | 无 | HTTPS URL | 所有图片字段统一要求:PNG / JPEG / WebP / BMP;单文件≤20MiB;宽、高均240~8000像素;宽高比1:8~8:1;PNG必须可确认无透明通道 | 否 |
image_with_roles[].role |
数组内图片的用途 | string | 数组内是 | 无 | first_frame / last_frame / reference_image | 首尾各≤1张;参考图和image_urls合计≤10张;首尾帧模式不搭配参考音视频 | 否 |
first_frame_image |
约束视频开始画面的图片地址 | string | 首帧/首尾帧模式需提供;可用对应角色替代 | 无 | 首帧URL | 首帧≤1张,与参考素材互斥;图片规格见image_with_roles[].url | 否 |
last_frame_image |
约束视频结束画面的图片地址 | string | 尾帧/首尾帧模式需提供;可用对应角色替代 | 无 | 尾帧URL | 尾帧≤1张,与参考素材互斥;图片规格见image_with_roles[].url | 否 |
video_urls |
参考视频地址数组 | string[] | 否 | 无 | ≤5段 | MP4 / MOV;单文件≤100MiB;单段1~15秒;视频合计≤15秒;宽、高均240~4096像素;宽高比1:8~8:1 | 否 |
audio_urls |
参考音频地址数组 | string[] | 否 | 无 | ≤5段 | PCM WAV / MP3(含Xing/Info);单文件≤15MiB;单段1~15秒;音频合计≤15秒;可单独作为参考素材 | 否 |
seed |
随机种子 | integer | 否 | 未指定 | 0~2147483647 | 随机种子 | 是 · Seedance / Wan / Vidu |
watermark |
是否请求输出水印 | boolean | 否 | false | true / false | 输出水印 | 是 · H3 / H3 Max / Seedance / Wan |
nsfw_check |
额外审核选项,本版仅接受false | boolean | 否 | false | 仅false | true不支持 | 是 · 除Vidu与Regeneration外的型号 |
目录展示已实现的适配能力,不代表所有型号或规格均向当前账户开放。实际启用状态、权限与默认值以本人 /v1/models 为准。
查看完整请求字段与限制(中文)↗CREATIVE WORKFLOWS
适用场景
- 在独立授权下评估 Prime 型号。
- 构建文字或参考素材驱动的视频流程。
- 按所选模式核对自动时长和声音选项。
PRICING / USD
按所选规格计费。
API INTEGRATION
接入示例
在自己的服务端使用 HTTP 接入,选择模型与参数;先由服务方配置账户、Key 和逐模型权限。
202 表示已受理。保存任务编号,按 next_poll_after_seconds 查询;生成状态、产物可用性与费用状态分别判断。
HTTP / cURL
curl --request POST 'https://bytesota-api.businessmodelcraft.com/v1/videos/generations' \
--header 'Authorization: Bearer YOUR_PLATFORM_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: example-wan-3.0-prime-text-480P-001' \
--data-raw '{
"model": "wan-3.0-prime",
"prompt": "小猫沿花园小径向前走,镜头缓缓跟随。",
"duration": 5,
"resolution": "480P",
"aspect_ratio": "16:9",
"generate_audio": true
}'
查询结果
HTTP / cURL
curl 'https://bytesota-api.businessmodelcraft.com/v1/tasks/vid_ABCDEFGHIJKLMNOP' \
--header 'Authorization: Bearer YOUR_PLATFORM_API_KEY'
示例仅供复制,不会在网页中执行;凭证为占位符。
规格与示例来源:模型定义及公开 API 接入指南。
阅读完整 API 文档(中文)↗