curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "wan-3.0",
"prompt": "一只金毛寻回犬在日落时分的海滩上奔跑，镜头平稳跟随，画面具有自然细腻的电影质感。",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"generate_audio": true
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}创建 Wan 视频
通过统一的 POST /v1/videos 创建 Wan 视频任务。模型能力以当前 Tikway 网关实际可调用范围为准。
| 模型 | 分辨率 | 时长 | 支持模式 | 音频 | 参考限制 |
|---|---|---|---|---|---|
wan-3.0 | 480p / 720p / 1080p | 2–30 秒或 -1 智能时长 | 文生、首帧、首尾帧、全模态参考 | 支持，默认开启 | 10 图 / 5 视频 / 5 音频；另可传 1 个文件或链接 |
wan-2.7 | 720p / 1080p | 生成 2–15 秒；参考/编辑 2–10 秒 | 文生、首帧、首尾帧、续写、参考、编辑 | 支持 | 模式相关 |
wan-2.6 | 720p / 1080p | 生成 2–15 秒；参考 2–10 秒 | 文生、首帧、参考；首尾帧/编辑使用兼容模型 | 支持；兼容模式可能无声 | 参考生视频 1–5 个图片/视频 |
来源：阿里云视频生成模型总览。官网能力与当前网关未开放能力之间的差异见本次审计报告。
curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "wan-3.0",
"prompt": "一只金毛寻回犬在日落时分的海滩上奔跑，镜头平稳跟随，画面具有自然细腻的电影质感。",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"generate_audio": true
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
创建 Wan 视频任务。参数按当前 Tikway 网关能力收窄；模型之间的差异见 operation 描述与 x-model-capabilities。
Wan 模型 ID。
wan-3.0, wan3.0-video, wan-2.7, wan-2.6 视频生成或编辑提示词。
1Wan 2.6/2.7 可用。Wan 3.0 不支持顶层 negative_prompt；如上游扩展已支持，请放入 extra_body。
仅 wan-2.6 支持精确像素尺寸；其他 Wan 模型请使用 resolution + aspect_ratio。
^[1-9][0-9]*[x*][1-9][0-9]*$视频时长（秒）。Wan 3.0 为 2–30 或 -1；Wan 2.7/2.6 的上限随生成模式变化，详见模型能力表。
-1 <= x <= 30视频宽高比。图生视频时，部分模型会按输入素材自动决定比例。
adaptive, 16:9, 9:16, 1:1, 4:3, 3:4 输出分辨率。不同模型或模式的可用值见模型能力表。
480p, 720p, 1080p Wan 参考素材。不同模型和模式的数量限制不同；Wan 3.0 的参考素材不能与首尾帧混用，file 与 link 互斥。
21- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
Hide child attributes
Hide child attributes
图片 URL 字符串。
1可选。素材类型；若提供，必须与对应 URL 字段一致。
image_url, video_url, audio_url, file_url, link_url 素材用途。省略时按 URL 字段推断为普通参考素材。
reference_image, reference_video, reference_audio, source_video, first_clip, driving_audio, file, link 视频 URL 字符串。
1音频 URL 字符串。
1文件 URL 字符串。
1网页 URL 字符串。
1预设音色 ID；仅部分支持音色参考的模型使用。
1是否生成音频。Wan 3.0 默认开启；Wan 2.6/2.7 的具体行为由模式决定。
随机种子。固定种子只能提高可复现性，不保证输出完全一致。
-1 <= x <= 2147483647用户任务回调地址。由 Tikway 在任务状态变化后调用，不直接传给模型上游。
^https://响应
POST /v1/videos 创建视频任务成功后的响应参数，接口返回 HTTP 202。
视频生成任务的唯一标识，用于后续查询任务状态。
1"9552de3d-171f-4cca-b492-7baa56523239"
任务创建状态。pending 表示任务已创建、等待提交处理；queue 表示任务已进入生成队列。
pending, queue "queue"
视频任务查询地址，客户端可通过 GET 请求轮询任务状态。
^https://"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"