视频生成

Live

提交异步视频任务并核对任务状态。

(opens in new tab)最后核对: 2026-09-08

选择 Wan 3 模式

modelrush/wan3-spicy、modelrush/wan3-pro-spicy、modelrush/wan3-prime-spicy 与 modelrush/wan3-prime-pro-spicy 共用一个异步接口，并提供三种模式：

模式	必需素材	适用场景
`text-to-video`	无	根据 Prompt 生成视频
`image-to-video`	`first_frame`；`last_frame` 可选	单图动画或首尾帧插值
`reference-to-video`	至少一个参考素材数组	用图片、视频与音频保持主体、动作或声音

Wan 3 的 Prompt 最长 20,000 字符，时长支持 2–30 秒或用 -1 智能决定，并支持自适应/固定画幅、原生音频与提示词扩展。标准版和 Prime Spicy 支持 480P、720P、1080P；Pro 和 Prime Pro Spicy 支持 1080P、2K、4K。Prime 档以更高的每秒价格换取更快的生成速度。

提交文生视频任务

bash
curl https://api.modelrush.ai/v1/videos/generations \
  -H "Authorization: Bearer $MODELRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"modelrush/wan3-spicy","mode":"text-to-video","prompt":"一只月球狐狸在发光的区域之间追踪请求","duration":5,"resolution":"1080P","ratio":"16:9","audio":true}'

图生视频把 mode 改为 image-to-video，并添加 first_frame 与可选的 last_frame。参考生视频把 mode 改为 reference-to-video，最多可传 10 个 reference_images、5 个 reference_videos 和 5 个 reference_audios。接口返回 202、generation ID 和 queued 状态。

通过 Webhook 接收完成结果（推荐）

调用 POST /webhooks/endpoints 注册公开 HTTPS Endpoint。异步任务完成后，ModelRush 会立即推送已签名的 prediction.succeeded 或 prediction.failed 事件。请验签并按 Event ID 去重，详见 Webhook。

Webhook 投递延迟时，再用轮询作为恢复手段：

bash
curl https://api.modelrush.ai/v1/videos/generations/GENERATION_ID \
  -H "Authorization: Bearer $MODELRUSH_API_KEY"

使用有限次数的退避轮询，直到视频接口返回 completed 或 failed；成功时读取 video_url。统一 Prediction 接口使用 succeeded 和 outputs。详见异步任务。

Spicy 模型 API 说明

打开模型页查看请求参数与当前价格。四个 Wan 3 落地页都在 Playground 下方提供开发者 API 区域。通过 GET /v1/models 获取当前参数结构及密钥可访问的模型；GET /api/model-pricing 返回当前客户售价。

模型与 API 说明	模型 ID	接口
Wan 3 Spicy	`modelrush/wan3-spicy`	`POST /v1/videos/generations`
Wan 3 Pro Spicy	`modelrush/wan3-pro-spicy`	`POST /v1/videos/generations`
Wan 3 Prime Spicy	`modelrush/wan3-prime-spicy`	`POST /v1/videos/generations`
Wan 3 Prime Pro Spicy	`modelrush/wan3-prime-pro-spicy`	`POST /v1/videos/generations`
Wan 2.7 I2V Spicy	`modelrush/wan2.7-i2v-spicy`	`POST /v1/videos/generations`
Wan 2.2 I2V Spicy	`modelrush/wan2.2-i2v-spicy`	`POST /v1/videos/generations`
Wan 2.2 I2V LoRA Spicy	`modelrush/wan2.2-i2v-lora-spicy`	`POST /v1/videos/generations`
Wan Animate Spicy	`modelrush/wan-animate`	`POST /v1/videos/generations`
FlashVSR Spicy	`modelrush/flashvsr`	`POST /v1/videos/generations`

GET /v1/videos/generations/:id 的终态为 completed 或 failed，成功时返回 video_url；统一 GET /v1/predictions/:id 则使用 succeeded 和 outputs。请按实际 poll_url 的契约处理。Wan 3 的参考视频与生成视频合计不能超过 30 秒；目前仅 Prime 与 Prime Pro 接受 prompt_extend，以各模型 schema 为准。LoRA 支持三组可选权重数组、480P/720P 和 5/8 秒。Wan Animate、FlashVSR 携带源素材调用视频生成接口。

所有 Spicy 模型要求账户完成成人访问确认，API Key 也必须允许对应模型和能力。密钥只保存在服务端，同一次提交的重试复用 Idempotency-Key。

上一页图像编辑

下一页音频 API