POST /images/edits

编辑源图；GPT Image 2 接受一张图和可选 mask。换脸和换头必须获得明确肖像授权。 Base URL 为 https://api.modelrush.ai/v1。

字段：model 与 image（URL/data URI 或数组；multipart 使用重复的 image 文件字段）。图片数量、prompt 和可选字段以 operations.input_schema 为准。换脸/换头要求按 schema 顺序提供两张图片及 person_rights_confirmed=true，prompt 可选；Qwen Image Edit 必须提供 prompt。已认证路由发送 Authorization: Bearer $MODELRUSH_API_KEY；JSON Body 发送 Content-Type: application/json。

字段：异步模型返回 HTTP 202、id 和 poll_url；GET /predictions/:id 成功时为 succeeded 并包含 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 时返回该账户实际适用的价格。

Qwen Image Edit Spicy、Face Swap Spicy 和 Head Swap Spicy 使用 POST /v1/images/edits，不是图像生成接口。结果为异步（HTTP 202）：保存 poll_url，状态为 succeeded 后读取 outputs。换脸与换头还要求账户肖像授权确认及每次请求的 person_rights_confirmed；图片顺序和必填字段以各模型 schema 为准。