Minimax Image 01 Image To Image
Playground
Try it on WavespeedAI!MiniMax Image-01 image-to-image model transforms existing images using text prompts. Generate variations, apply style transfers, or modify images with character references. Supports multiple aspect ratios and custom dimensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
MiniMax Image-01 Image-to-Image
MiniMax Image-01 Image-to-Image is an advanced AI model that transforms existing images using text prompts. Part of the MiniMax image-01 family, this model enables you to generate variations, apply style transfers, modify compositions, and create character-consistent images from reference photos. Perfect for creative workflows, product visualization, and content creation.
Key Features
-
Image-Based Generation Generate new images based on an existing image input combined with text prompts. The model intelligently understands the reference image and applies your text description to create variations.
-
Character Reference Support Use portrait photos as character references to maintain consistent character appearance across generated images. Ideal for creating character variations, different poses, or placing characters in new scenes.
-
Flexible Image Dimensions Specify custom dimensions from 512×512 to 2048×2048 pixels (must be divisible by 8) for precise control over output size. Common sizes include 1024×1024, 1280×720, 1152×864, and more.
-
Prompt Optimization Built-in prompt optimizer automatically enhances your text descriptions for better generation results, helping you achieve the desired output even with simple prompts.
-
Batch Generation Generate up to 9 images in a single request, perfect for exploring variations and selecting the best result.
-
Reproducible Results Use seed values to generate consistent results across multiple runs, essential for iterative refinement and production workflows.
Use Cases
- Product Visualization: Transform product photos into different contexts, backgrounds, or styles
- Character Art: Create consistent character variations with different poses, outfits, or environments
- Style Transfer: Apply artistic styles or visual treatments to existing images
- Image Editing: Modify specific aspects of an image through natural language descriptions
- Creative Exploration: Generate multiple variations of a concept for selection and refinement
- Content Creation: Quickly produce social media content, marketing materials, or creative assets
Supported Formats & Dimensions
Input Image Formats:
- JPG, JPEG, PNG
- Maximum file size: 10MB
- Accepts public URLs or Base64-encoded Data URLs
Output Dimensions:
- Width/Height range: 512 to 2048 pixels
- Must be divisible by 8
- Common sizes: 1024×1024 (square), 1280×720 (widescreen), 1152×864 (standard), 1248×832 (photo), 832×1248 (portrait photo), 864×1152 (portrait), 720×1280 (mobile/vertical), 1344×576 (ultra-wide)
How to Use
Basic Image-to-Image Generation
-
Upload Reference Image
- Provide a public URL or Base64-encoded image in the
imagefield - Ensure the image is in JPG, JPEG, or PNG format and under 10MB
- Provide a public URL or Base64-encoded image in the
-
Write Your Prompt
- Describe the desired output in the
promptfield (max 1500 characters) - Example: “Transform this photo into a watercolor painting style with soft pastel colors”
- Describe the desired output in the
-
Select Image Size
- Specify dimensions using the
sizeparameter like “10241024” or “1280720” - Choose dimensions that match your use case (square for social media, widescreen for presentations, etc.)
- Specify dimensions using the
-
Configure Options
num_images: Set 1-9 to generate multiple variationsprompt_optimizer: Enable for automatic prompt enhancementseed: Use for reproducible results
-
Generate
- Submit your request and receive generated images as URLs or Base64 strings
Character Reference Generation
For consistent character appearance:
-
Prepare Portrait Photo
- Use a clear, front-facing portrait with good lighting
- Single person in frame works best
-
Configure Character Reference
- Use the
subject_referenceparameter with type “character” - Provide the portrait image URL or Base64 data
- Use the
-
Describe the Scene
- Write a prompt describing the desired scene, pose, or context
- Example: “The character standing on a mountain peak at sunset”
API Parameters
- prompt (required): Text description of desired output (max 1500 chars)
- image (required): Reference image as URL or Base64 string
- size: Image dimensions (e.g., “1024 * 1024”, “1280 * 720”)
- num_images: Number of images to generate (1-9, default: 1)
- seed: Random seed for reproducible results
- prompt_optimizer: Enable automatic prompt enhancement (boolean)
- enable_base64_output: Return Base64 instead of URLs (boolean)
- enable_sync_mode: Wait for generation to complete before returning (boolean)
- subject_reference: Array of character reference images (optional)
Pricing
- $0.0035 per image
- Generate multiple images in one request for efficient batch processing
- Total cost = $0.0035 × number of images generated
Output Format
Generations return as:
- URLs (default): Direct links to generated images hosted on WaveSpeedAI
- Base64 (optional): Encoded image data for direct embedding
Response includes:
- Unique request ID for tracking
- Generation status (created, processing, completed, failed)
- Output array with generated image URLs or Base64 data
- NSFW content detection flags
- Creation timestamp
Best Practices
- Use clear, well-lit reference images for best results
- For character references, front-facing portraits work best
- Enable prompt optimizer if you’re new to prompt writing
- Use seed values when iterating on a specific result
- Generate multiple variations (num_images > 1) to select the best output
- Keep prompts descriptive but concise for optimal results
Related Models
Also available on WaveSpeedAI:
- minimax/image-01/text-to-image - Generate images from text prompts only
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/minimax/image-01/image-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"size": "1024*1024",
"num_images": 1,
"prompt_optimizer": false,
"enable_sync_mode": false,
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | Text description of the image, max length 1500 characters. | |
| image | string | No | - | Reference image file. Supports public URLs or Base64-encoded | |
| size | string | No | 1024*1024 | 512 ~ 2048 per dimension | Specify the width and height pixel values of the generated image. |
| num_images | integer | No | 1 | 1 ~ 9 | The number of images to generate. |
| seed | integer | No | - | -1 ~ 2147483647 | Random seed. Using the same seed and parameters produces reproducible images. If not provided, a random seed is generated for each image. |
| prompt_optimizer | boolean | No | false | - | Enable automatic optimization of prompt. |
| enable_sync_mode | boolean | No | false | - | If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |