Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| prompt | Description of the desired edits, supports up to 32,000 characters | string | Yes | - |
| images | Input image URL(s) to edit. Direct HTTPS URLs as string array. Supports up to 16 images for GPT Image models | string[] | Yes | - |
| background | Background transparency. ‘transparent’: transparent background (requires png or webp format), ‘opaque’: solid background, ‘auto’: model decides | string | No | transparent, opaque, auto |
| input_fidelity | Control fidelity to original input image. ‘high’: preserve original details, ‘low’: more creative freedom | string | No | high, low |
| mask | Optional mask URL. Must be PNG with alpha channel; dimensions must match the input image exactly. Transparent areas are edited, opaque areas locked, semi-transparent areas blend with the original. | string | No | - |
| quality | Output quality level. ‘low’: fast draft (default), ‘medium’: balanced, ‘high’: best quality | string | No | low, medium, high |
| size | Output image size. Preset resolutions only | string | No | 1024x1024, 1536x1024, 1024x1536 |
Pricing
Unit: $/img
| Dimension | Pricing |
|---|---|
| quality: low / size: 1024x1024 | 0.0140 |
| quality: low / size: 1536x1024 | 0.0190 |
| quality: low / size: 1024x1536 | 0.0190 |
| quality: medium / size: 1024x1024 | 0.0440 |
| quality: medium / size: 1536x1024 | 0.0630 |
| quality: medium / size: 1024x1536 | 0.0630 |
| quality: high / size: 1024x1024 | 0.1600 |
| quality: high / size: 1536x1024 | 0.2400 |
| quality: high / size: 1024x1536 | 0.2400 |
Related Models
- openai/gpt-image-1.5: [Core Function] GPT Image 1.5 is a versatile text-to-image generation model. [Strengths] It balances solid visual performance with crucial utility features, notably its native support for generating images with transparent backgrounds. [Best For] Highly recommended for: creating UI icons, standalone logos, game assets, and any graphic design elements that require a transparent background. [Limitations] Do NOT use this model if you need 2K or 4K resolution. Its maximum supported resolution is 1536x1024. [Routing] Choose this model specifically when the user asks for ‘transparent background’, ‘no background’, or ‘PNG icon’. For standard, high-fidelity, or 4K image generation, use GPT Image 2 instead.
- openai/gpt-image-2: [Core Function] GPT Image 2 is a state-of-the-art text-to-image generation model. [Strengths] It excels at generating highly detailed, photorealistic images from text descriptions, with native support for ultra-high resolutions including 2K and 4K (up to 3840x2160). [Best For] Highly recommended for: cinematic landscapes, detailed character portraits, high-end commercial concept art, and any scenario requiring maximum resolution and visual fidelity. [Limitations] Do NOT use this model if you need a transparent background (e.g., for icons or UI assets), as it does not support the
background: transparentparameter. [Routing] Use this model by default for all high-quality image generation requests. If the user explicitly asks for an image with a transparent background, route to GPT Image 1.5 instead. - openai/gpt-image-2-edit: [Core Function] GPT Image 2 Edit is a high-resolution image-to-image editing model. [Strengths] It excels at making high-fidelity edits and style transformations to a single source image based on a text prompt, preserving details at up to 4K resolutions. [Best For] Highly recommended for: professional photo retouching, upscaling style transfers, and modifying high-resolution concept art. [Limitations] Do NOT use this model for multi-image merging (it only accepts one input image). Do NOT use if you need precise input fidelity control or transparent backgrounds. [Routing] Use this model by default when the user wants to edit a single image and prioritize output resolution/quality. If they need to merge multiple images or control the strictness of the edit (fidelity), use GPT Image 1.5 Edit.
- alibaba/wan2.7-image-pro-edit: [Core Function] Wan 2.7 Image Pro Edit is Alibaba’s flagship reasoning-enhanced image editing model. [Strengths] It supports interactive editing, character-consistent multi-image generation, and complex multi-reference modifications with deep reasoning. [Best For] Highly recommended for: professional image retouching, consistent character sheets, and complex structural edits. [Limitations] Do NOT use this model if you specifically need to use negative prompts to exclude elements during editing (use Qwen Image 2.0 Pro Edit instead). [Routing] Use this by default for high-end image editing and multi-reference consistent character generation.
- bytedance/seedream-5.0-lite-edit: [Core Function] Seedream 5.0 Lite Edit is a reasoning-enhanced, smart image editing model. [Strengths] It features superior cross-modal understanding and reasoning, allowing for highly accurate, interactive multi-turn image editing with real-time knowledge enhancement. [Best For] Highly recommended for: complex image editing tasks, structural modifications, and edits requiring deep semantic understanding. [Limitations] As a ‘Lite’ model, raw visual rendering might not match the 4.5 tier. [Routing] Use this model by default for complex, reasoning-based image editing tasks.
- xai/grok-imagine-image-quality-edit: [Core Function] Grok Imagine Image Edit (Quality) is xAI’s high-fidelity image editing model. [Strengths] It excels at applying detailed, prompt-guided edits and style transformations to one or more source images while preserving fine detail. [Best For] Highly recommended for: high-quality restyling, detailed inpainting-style edits, and combining up to 3 source images. [Limitations] Do NOT use this model when latency is critical, as it is slower than the standard edit variant; a maximum of 3 source images is supported. [Routing] Use this model by default for quality-sensitive edits. For faster edits, route to Grok Imagine Image Edit (standard).
- alibaba/qwen-image-2.0-pro-edit: [Core Function] Qwen Image 2.0 Pro Edit is a highly controllable professional image editing model. [Strengths] It seamlessly unifies generation and editing, supporting NEGATIVE prompts during the editing process to strictly exclude elements. [Best For] Highly recommended for: precise image editing where specific elements must be removed or avoided. [Limitations] Does not feature the explicit ‘Thinking Mode’ reasoning of Wan 2.7. [Routing] Route to this model specifically when the user wants to edit an image AND provides a ‘negative prompt’ to exclude elements.
- microsoft/mai-image-2.5-edit: [Core Function] MAI Image 2.5 Edit is Microsoft’s flagship image editing model. [Strengths] It excels at applying high-quality, prompt-guided edits and transformations to a single source image. [Best For] Highly recommended for: restyling, object/scene modification, and detailed prompt-driven edits. [Limitations] Do NOT provide more than one source image or non-JPEG/PNG inputs; it accepts exactly one JPEG or PNG image, and output is always PNG. [Routing] Use this model by default for quality-sensitive edits. For faster, cheaper edits, route to MAI Image 2.5 Flash Edit.
- google/nano-banana-2: [Core Function] Nano Banana 2 (Gemini 3.1 Flash Image) is an extremely fast text-to-image model. [Strengths] It is optimized for high-speed, high-volume visual generation, creative prompting, and rapid stylistic experimentation. [Best For] Highly recommended for: rapid creative iteration, generating large batches of images quickly, and artistic/stylized graphics. [Limitations] Do NOT use this model if you require strict, high-end photorealism (use the Imagen 4 series instead). [Routing] Route to this model for ‘fast’, ‘creative’, or ‘stylized’ high-volume requests.
- google/nano-banana-pro: [Core Function] Nano Banana Pro (Gemini 3 Pro Image) is a high-capability creative image model. [Strengths] It balances the creative flexibility and speed of the Nano series with higher fidelity output. [Best For] Highly recommended for: high-quality stylized art and complex creative compositions. [Limitations] Do NOT use for absolute photorealism (use Imagen 4). [Routing] Use this model for high-quality, creative, non-photorealistic requests.
- kling/kling-v3-t2i: [Core Function] Kling V3 T2I is the flagship text-to-image generation model. [Strengths] It delivers state-of-the-art aesthetic quality, high-resolution outputs (up to 2K), and exceptional prompt adherence. [Best For] Highly recommended for: professional concept art, photorealistic portraits, and high-fidelity image generation. [Limitations] Do NOT use this model if you need to strictly reference or edit an existing image. [Routing] Use this as the default model for all text-to-image requests on the Kling platform.
- kling/kling-avatar: [Core Function] Kling Avatar is a specialized portrait animation model. [Strengths] It precisely animates a portrait image to lip-sync with an audio file or TTS audio ID. [Best For] Highly recommended for: virtual presenters, talking head videos, and digital avatars. [Limitations] Do NOT use this model for full-body action or general image animation. [Routing] Use this model explicitly when the user wants to make a portrait ‘speak’ with provided audio.
- skywork/single-actor-avatar: [Core Function] SkyReels Single-Actor Avatar (audio-to-video) drives a talking-avatar video from a single portrait image and one audio track. [Strengths] Lip-synced single-speaker talking-head video generated from an image plus audio. [Best For] Virtual presenters, single-speaker dubbing, and talking avatars. [Limitations] Do NOT use this for multi-speaker scenes (use the multi-actor flow) or when you only have text. It requires first_frame_image and exactly one audio segment (<=200s). mode=std outputs 720p, mode=pro outputs 1080p. [Routing] Provide a portrait first_frame_image and one audio URL in audios; choose mode=pro for 1080p output.
- vidu/viduq2-pro-digital-human: [Core Function] Vidu Q2 Pro Digital Human is a premium portrait animation model. [Strengths] It excels at generating highly realistic, expressive digital humans from a single portrait image, featuring precise lip-sync to audio and natural facial micro-expressions. [Best For] Highly recommended for: professional virtual spokespersons, high-end educational videos, news anchoring, and realistic character animation. [Limitations] Do NOT use this model for complex full-body physical interactions or videos longer than 10 seconds. [Routing] Use this by default for ‘talking head’ or ‘digital human’ requests prioritizing realism over speed.
- bytedance/seedream-4.5-i2i: [Core Function] Seedream 4.5 I2I is a high-fidelity image editing model. [Strengths] It provides high-consistency, high-resolution style transfer and image-to-image transformations. [Best For] Highly recommended for: professional aesthetic modifications and high-resolution edits. [Limitations] Lacks the advanced reasoning of 5.0 Lite. [Routing] Use this for pure aesthetic/high-fidelity edits.



