POST /images/edits

Edit source images; GPT Image 2 accepts one image and an optional mask. Face and head swap require explicit portrait authorization. The base URL is https://api.modelrush.ai/v1.

model and image (a URL/data URI or an array; repeated image files in multipart). Required image count, prompt and optional fields depend on operations.input_schema. Face/head swap require two images in schema order and person_rights_confirmed=true; prompt is optional. Qwen Image Edit requires prompt. Send Authorization: Bearer $MODELRUSH_API_KEY for authenticated routes and Content-Type: application/json for JSON bodies.

Async models: HTTP 202 with id and poll_url; success via GET /predictions/:id is succeeded with outputs. Synchronous models return id, generation_request_id, model, modelrush_region, data. Preserve returned request or generation identifiers. Generated outputs and their Provider file references are removed from the ModelRush database 24 hours after request completion; download anything you need to keep.

Invalid inputs return a 4xx response with a structured error. A 403 with adult_attestation_required, portrait_rights_attestation_required, or person_rights_confirmation_required must be resolved by the account user and must never be retried automatically. Retry 429 according to Retry-After; retry 5xx failures only with a bounded backoff policy.

Open a model page for its request parameters and current prices. The four Wan 3 landing pages include a developer API section below the Playground. Read GET /v1/models for current schemas and key-specific access; GET /api/model-pricing returns public prices without authentication; with a valid Bearer API key, it returns the prices applicable to that account.

Qwen Image Edit Spicy, Face Swap Spicy and Head Swap Spicy use POST /v1/images/edits, not the image generation endpoint. Their result is asynchronous (HTTP 202): save poll_url and read outputs after status succeeded. Face and head swaps additionally require the account's portrait-rights attestation and per-request person_rights_confirmed; use each model's schema for image ordering and required fields.