Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| prompt | Image description text, supports Chinese and English | string | Yes | - |
| subject_reference_images | Reference image URLs for image-to-image generation. Supports public HTTPS URLs or Base64 Data URLs | string[] | Yes | - |
| aspect_ratio | Image aspect ratio. If both aspect_ratio and width/height are provided, aspect_ratio takes priority | string | No | 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9 |
| height | Image height in pixels (must be used with width). Must be divisible by 8. If aspect_ratio is provided, width/height will be ignored | integer | No | - |
| n | Number of images to generate per request | integer | No | - |
| prompt_optimizer | Enable automatic prompt optimization to improve generation quality | boolean | No | true, false |
| seed | Random seed for reproducible results. Use the same seed with same parameters to generate identical images | integer | No | - |
| width | Image width in pixels (must be used with height). Must be divisible by 8. If aspect_ratio is provided, width/height will be ignored | integer | No | - |
Pricing
Unit: $/img
| Pricing |
|---|
| $0.0040/img |
Related Models
- 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.
- kling/kling-v3-i2i: [Core Function] Kling V3 I2I is the flagship image-to-image editing model. [Strengths] It provides high-quality style transfer and image modification up to 2K resolution based on a reference image. [Best For] Highly recommended for: high-res style transfer and general image editing. [Limitations] Do NOT use this model for complex multi-element fusion (use Omni Image instead). [Routing] Use this by default for standard image-to-image tasks.
- 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.
- google/nano-banana-2-edit: [Core Function] Nano Banana 2 Edit is a high-speed image editing model. [Strengths] It rapidly modifies existing images or extracts image frames from videos based on text prompts. [Best For] Highly recommended for: rapid style transfer, quick image modifications, and fast creative edits. [Limitations] Do NOT use this model for meticulous photorealistic retouching. [Routing] Use this model by default for fast, creative image editing tasks.
- xai/grok-imagine-image-edit: [Core Function] Grok Imagine Image Edit is xAI’s standard image editing model. [Strengths] It excels at quickly applying prompt-guided edits and style changes to one or more source images. [Best For] Highly recommended for: fast restyling, quick variations, and lightweight image edits. [Limitations] Do NOT use this model when maximum edit fidelity is required; the Quality variant preserves more detail. A maximum of 3 source images is supported. [Routing] Choose this model for fast edits. When the user demands maximum fidelity, route to Grok Imagine Image Edit (Quality).
- 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).
- pixverse/video-restyle: [Core Function] PixVerse Restyle re-renders an existing video into a new visual style. [Strengths] Consistent style transfer across all frames. [Best For] Turning footage into anime/3D/painterly looks, stylized remixes. [Limitations] Do NOT use this to change content, motion, or add new scenes; it only re-renders the visual style of an existing video. It requires an input video, and you must provide EITHER restyle_id (a preset style code from the PixVerse restyle list) OR restyle_prompt (free-text style, max 2048 chars), not both. [Routing] Use when the user wants to change the look of an existing video. Use restyle_id for an official preset, restyle_prompt for a custom style.
- xai/grok-imagine-video-edit: [Core Function] Grok Imagine Video Edit applies a prompt-guided transformation to an input video. [Strengths] It excels at restyling and modifying an existing video while keeping its original duration and aspect ratio. [Best For] Highly recommended for: restyling clips, applying visual effects, and prompt-driven video edits. [Limitations] Do NOT use this model to change the duration, aspect ratio, or resolution; the output preserves the input video’s duration and aspect ratio, and those parameters are not configurable. Input video constraints (e.g. format/length) are enforced by the upstream provider. [Routing] Use this model when the user provides a video and wants it edited/restyled. To make a video longer, use Video Extend.
- google/gemini-omni-flash-r2v: [Core Function] Gemini Omni Flash R2V (Reference-to-Video) generates a short 720p video guided by up to three reference images via the Interactions API. [Strengths] It fuses the styles, subjects, or elements from multiple reference images (referred to in the text prompt) into a single coherent animated clip with synchronized audio. [Best For] Highly recommended for: blending characters or visual styles from several images, reference-guided creative shots, and multi-subject compositions where the prompt directs how the references combine. [Limitations] Do NOT use this model if you only have a single starting frame (use I2V instead), or if you need 1080p or 4K or clips longer than 10 seconds; it accepts 1 to 3 reference images and outputs 720p up to 10 seconds (16:9 or 9:16). [Routing] Choose this when the user supplies multiple reference images to combine into one video. For single first-frame animation use Gemini Omni Flash I2V; to modify an existing video use Gemini Omni Flash Video Edit.
- google/gemini-omni-flash-video-edit: [Core Function] Gemini Omni Flash Video Edit performs conversational, instruction-driven editing of an existing video via the Interactions API. [Strengths] It applies natural-language edits (changing the scene, mood, style, lighting, background, or time of day) to an input video while preserving the source video’s length and aspect ratio, with synchronized audio. [Best For] Highly recommended for: re-styling or re-lighting an existing clip, changing a video’s setting or atmosphere, and quick instruction-based revisions of a short video. [Limitations] Do NOT use this model to generate a video from scratch (use T2V, I2V, or R2V), and do NOT expect to change the output resolution, aspect ratio, or duration: the output preserves the source video’s aspect ratio and length, and the model does not accept aspectRatio or duration parameters. The source video should be 3 to 10 seconds. [Routing] Choose this only when the user provides an existing video to modify. To create a new video from text or images, use Gemini Omni Flash T2V, I2V, or R2V instead.
- kling/kling-v3-omni-image: [Core Function] Kling V3 Omni Image is a unified multimodal image generation endpoint. [Strengths] It supports complex element extraction and character consistency, allowing you to generate series of images with consistent subjects/elements using
<image_N>syntax. [Best For] Highly recommended for: generating comic books, character design sheets, and maintaining strict visual consistency across multiple generations. [Limitations] Do NOT use this model for simple, single-shot text-to-image tasks. [Routing] Use this model when the user requests ‘consistent characters’ or needs to fuse multiple image elements into a new scene. - 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/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.