Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| prompt | Text description of the edit to apply | string | Yes | - |
| images | Source images to edit (1-3). Each item is a publicly accessible image URL or a base64 data URI. | string[] | Yes | - |
| aspect_ratio | Aspect ratio of the edited output image | string | No | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, auto |
| n | Number of edited images to generate | integer | No | - |
| resolution | Output resolution: 1k (1024px) or 2k (2048px). Defaults to 1k. | string | No | 1k, 2k |
| response_format | Format of the returned image data | string | No | url, b64_json |
Pricing
Unit: $/img
| Dimension | Pricing |
|---|---|
| resolution: 1k | 0.0230 |
| resolution: 2k | 0.0230 |
Related Models
- xai/grok-imagine-image: [Core Function] Grok Imagine Image is xAI’s standard text-to-image generation model. [Strengths] It excels at quickly generating solid, visually appealing images from a text prompt across a wide range of aspect ratios. [Best For] Highly recommended for: rapid prototyping, social media content, and general-purpose image generation. [Limitations] Do NOT use this model when maximum detail or fidelity is required; the Quality variant produces richer detail. [Routing] Choose this model for fast, general image generation. When the user demands maximum fidelity, route to Grok Imagine Image (Quality).
- xai/grok-imagine-image-quality: [Core Function] Grok Imagine Image (Quality) is xAI’s high-fidelity text-to-image generation model. [Strengths] It excels at producing richly detailed, high-quality images from a text prompt, with flexible aspect ratios and an optional 2K resolution. [Best For] Highly recommended for: detailed concept art, marketing visuals, and any scenario where image quality is prioritized over generation speed. [Limitations] Do NOT use this model when latency is critical, as generation is slower than the standard model. [Routing] Use this model by default when the user emphasizes quality or detail. For faster, lighter generation use Grok Imagine Image (standard).
- xai/grok-imagine-video: [Core Function] Grok Imagine Video is xAI’s text-to-video generation model. [Strengths] It excels at generating short, dynamic video clips directly from a text prompt, with controllable duration, aspect ratio, and resolution. [Best For] Highly recommended for: short social clips, animated concepts, and dynamic scene generation from a description. [Limitations] Do NOT use this model when you have a starting image or reference subjects, or when you need resolutions above 720p or clips longer than 15 seconds; it is limited to 480p/720p and 15s. [Routing] Use this model when the user wants a video from text only. If a starting image is provided, route to the Image-to-Video model; for reference-driven character video, use Reference-to-Video.
- 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).
- xai/grok-imagine-video-1.5-i2v: [Core Function] Grok Imagine Video 1.5 I2V animates a single starting image into a video using the Grok Imagine 1.5 generation backbone. [Strengths] It excels at producing motion from one starting frame with the improved 1.5 model. [Best For] Highly recommended for: animating a photo or illustration when the 1.5 generation backbone is preferred. [Limitations] Do NOT use this model for text-only generation, for resolutions above 1080p, or for clips longer than 15 seconds; it requires a starting image and is limited to 480p/720p/1080p and 15s. [Routing] Use this model when the user provides one starting image and prefers the 1.5 backbone.
- xai/grok-imagine-video-i2v: [Core Function] Grok Imagine Video I2V animates a single starting image into a video. [Strengths] It excels at producing smooth motion from one starting frame, guided by a text prompt for the desired movement. [Best For] Highly recommended for: bringing a photo or illustration to life, dynamic product showcases, and quick cinematic motion from a still. [Limitations] Do NOT use this model for text-only generation, for resolutions above 720p, or for clips longer than 15 seconds; it requires a starting image and is limited to 480p/720p and 15s. [Routing] Use this model when the user provides exactly one starting image. For reference-driven character video, use Reference-to-Video; for text-only video, use Text-to-Video.
- xai/grok-imagine-video-r2v: [Core Function] Grok Imagine Video R2V generates a video from a text prompt while preserving the subjects shown in up to 7 reference images. [Strengths] It excels at keeping character/subject identity consistent across a newly generated scene driven by the prompt. [Best For] Highly recommended for: character-driven video, placing a specific subject into a new scene, and blending features from multiple references. [Limitations] Do NOT use this model to simply animate a single image as-is (use Image-to-Video), or for clips longer than 10 seconds or resolutions above 720p; duration is capped at 10s and resolution at 480p/720p. [Routing] Use this model when the user provides reference images of a subject and wants a new action/scene described by a prompt. To simply animate a single image as-is, use Image-to-Video.
- 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.
- xai/grok-imagine-video-extend: [Core Function] Grok Imagine Video Extend continues an existing video, generating additional footage beyond its end. [Strengths] It excels at seamlessly extending a clip with new prompt-guided motion. [Best For] Highly recommended for: lengthening short clips, continuing a scene, and adding follow-on action. [Limitations] Do NOT use the
durationparameter expecting it to set the total video length; it only controls the length of the appended segment (2-10 seconds). Input video constraints are enforced by the upstream provider. [Routing] Use this model when the user wants to make a video longer. To restyle or modify an existing video, use Video Edit. - 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.
- minimax/minimax-image-01-i2i: [Core Function] MiniMax Image-01 I2I is an image-to-image editing and variation model. [Strengths] It excels at generating new images based on a text prompt while structurally referencing one or more input images. [Best For] Highly recommended for: style transfer, generating variations of existing artwork, and structurally guided image creation. [Limitations] Do NOT use this model if you want to generate video or if you do not have a reference image. [Routing] Use this model when the user provides a reference image and a text prompt to generate a new image.
- 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.
- 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.
- 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.




