异步任务

图像、视频与音频请求共享内部 Prediction 记录。统一状态为 queued、processing、succeeded、failed、cancelled 和 expired。轮询前先保存返回的 generation/Prediction ID、模型、区域、提交时间与内部 job ID。

用指数退避加 Jitter 轮询 GET /predictions/:id。旧视频客户端可以继续使用 GET /videos/generations/:id。到达任一终态后停止，用户离开后由 Worker 继续核对。

Prediction 记录生命周期为七天。DELETE /predictions/:id 对终态任务返回不变的 Prediction；如果 Provider Operation 无法安全取消运行中任务，则返回 409 cancellation_not_supported。

在限流范围内可以重试状态读取。生成请求发生不确定超时时，不要盲目重新提交，否则可能新增一个计费任务；应先核对原请求。

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

MuleRouter 图像请求可能返回 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 秒；目前仅 Prime 与 Prime Pro 接受 prompt_extend，以各模型 schema 为准。LoRA 支持三组可选权重数组、480P/720P 和 5/8 秒。Wan Animate、FlashVSR 携带源素材调用视频生成接口。