POST /images/generations

根据选定模型的输出限制生成图像。 Base URL 为 https://api.modelrush.ai/v1。

字段：model、prompt。各模型的字段和限制以 GET /models → operations.input_schema 为准。Z-Image 使用 width/height 和 n=1；Z-Image Pro 还接受 prompt_extend。其他模型可能使用 size、quality、output_format、watermark 或 thinking_mode。已认证路由发送 Authorization: Bearer $MODELRUSH_API_KEY；JSON Body 发送 Content-Type: application/json。

字段：异步模型返回 HTTP 202、id、poll_url；轮询 GET /predictions/:id，达到 succeeded 或 failed 后读取 outputs。同步模型返回 id、generation_request_id、model、modelrush_region、data。保存返回的 request 或 generation 标识。生成输出及其 Provider 文件引用会在请求完成 24 小时后从 ModelRush 数据库清除；需要长期使用的结果请及时下载。

无效输入返回带结构化错误的 4xx。403 的 adult_attestation_required、portrait_rights_attestation_required 或 person_rights_confirmation_required 必须由账户用户处理，绝不能自动重试。429 按 Retry-After 重试；5xx 只能用有限次数退避重试。

打开模型页查看请求参数与当前价格。四个 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 每次也只生成一张。不要套用其他模型的尺寸或输出数量限制。