Wan 3 Spicy 参考生视频 API：请求、价格与轮询

用 Wan 3 Spicy API 提交已获授权的图片、视频或音频参考素材，估算五秒任务费用，并取回异步结果。

核心结论将 mode 设为 reference-to-video，并至少传入一种参考素材数组。先用一张图片和固定五秒时长测试，提交前查看账户报价。

什么时候使用参考生视频

如果要让新镜头借用产品外观、动作节奏或声音，却不锁定首帧，就用参考素材。Wan 3 Spicy 在同一个 POST /v1/videos/generations 接口中，最多接受 10 张 reference_images、5 段 reference_videos 和 5 段 reference_audios。reference-to-video 模式至少需要传入其中一种数组。不要同时传 first_frame 或 last_frame，这两个字段属于图生视频模式。

先用你拥有或获准使用的一张图片测试。对于简单的产品镜头，一张已确认的产品图比大量互相冲突的素材更容易评估。添加更多参考素材时，在提示词中写清每份素材的作用。

提交五秒任务

先在账户中完成 Spicy 模型的成人访问确认，并在服务端环境中设置 MODELRUSH_API_KEY。API key 需要视频权限和 Wan 3 Spicy 访问权限。把示例图片 URL 换成你有权处理、可通过 HTTPS 访问的图片。每次新任务只生成一次幂等键；同一次提交发生网络重试时复用该键。

bash
REQUEST_KEY="$(uuidgen)"
curl -sS https://api.modelrush.ai/v1/videos/generations \
  -H "Authorization: Bearer $MODELRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -d '{
    "model": "modelrush/wan3-spicy",
    "mode": "reference-to-video",
    "prompt": "参考图片中的蓝色陶瓷瓶放在石台上。一个连续镜头，摄影机缓慢顺时针环绕，暖色侧光照亮瓶身。",
    "reference_images": ["https://example.com/approved-bottle.jpg"],
    "duration": 5,
    "resolution": "480P",
    "ratio": "16:9",
    "audio": true
  }'

接口返回 HTTP 202、生成任务 ID、queued 状态和 poll_url。保存响应。如果提交后客户端超时，先查询已保存的任务，或用同一个幂等键重试，不要直接创建另一个任务。

轮询结果

把 202 响应里的相对路径 poll_url 复制到 POLL_URL，拼接 API 域名后用同一把 API key 请求。按有上限的间隔重复查询，直到视频接口返回 completed 或 failed。成功响应包含 video_url；需要保留的结果请及时下载，该 URL 可能在 24 小时后过期。

bash
curl -sS "https://api.modelrush.ai$POLL_URL" \
  -H "Authorization: Bearer $MODELRUSH_API_KEY"

核对时长与价格

Wan 3 Spicy 的输出时长必须是 2–30 秒的整数；省略时默认 5 秒，不能使用 -1。参考视频总长最多 15 秒，参考视频与生成视频合计不能超过 30 秒。参考音频总长最多 15 秒。网关会在提交生成前校验素材。

截至 2026 年 9 月 28 日，Wan 3 Spicy 的 480P 公开 Registry 价格为每输出秒 $0.045。上面只使用参考图片的五秒任务，按公开价格估算为 $0.225（5 × $0.045）。此例没有参考视频。你的账户价格可能不同；生成前显示的账户报价才是实际应参考的金额。提升分辨率或批量运行前，请在 Wan 3 Spicy 模型页或定价页核对当前价格。

完整参数见视频 API 文档。先查看 Wan 3 Spicy 模型详情，再到 Playground 试用参考生视频。