模型 API 概览

不同接口家族的模型 ID 不能互换。先确定输入输出契约，再使用 GET /models 查看当前可调用目录。Provider 发布研究数据只进入 Admin 接入候选队列，不会作为客户可调用模型返回。

在模型目录查看模型输入输出，在价格页查看商业条款，并通过 GET /regions 获取当前执行区域。

打开模型页查看请求参数与当前价格。四个 Wan 3 落地页都在 Playground 下方提供开发者 API 区域。通过 GET /v1/models 获取当前参数结构及密钥可访问的模型；GET /api/model-pricing 在未认证时返回公开价格；携带有效 Bearer API Key 时返回该账户实际适用的价格。

ModelRush 图像请求可能返回 HTTP 202、id 和 poll_url。携带同一 API Key 轮询该地址；GET /v1/predictions/:id 成功时返回 succeeded 状态和 outputs。Z-Image Pro Spicy 的 width、height 为 256–2560，默认 1024；n = 1，prompt_extend 默认 false。Z-Image Spicy 每次也只生成一张。不要套用其他模型的尺寸或输出数量限制。

GET /v1/videos/generations/:id 的终态为 completed 或 failed，成功时返回 video_url；统一 GET /v1/predictions/:id 则使用 succeeded 和 outputs。请按实际 poll_url 的契约处理。Wan 3 的参考视频与生成视频合计不能超过 30 秒；Wan 3 Spicy 四档均接受 prompt_extend（布尔值，默认 true），以各模型 schema 为准。LoRA 支持三组可选权重数组、480P/720P 和 5/8 秒。Wan Animate、FlashVSR 携带源素材调用视频生成接口。FlashVSR 的 duration 必须等于输入视频时长四舍五入到整秒（最少 1 秒），否则在扣费前返回 video_duration_mismatch（无法读取视频时返回 video_duration_unverified）。