Browse ModelsMinimaxMinimax Image 01 Image To Image

Minimax Image 01 Image To Image

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

  1. Upload Reference Image

    • Provide a public URL or Base64-encoded image in the image field
    • Ensure the image is in JPG, JPEG, or PNG format and under 10MB
  2. Write Your Prompt

    • Describe the desired output in the prompt field (max 1500 characters)
    • Example: “Transform this photo into a watercolor painting style with soft pastel colors”
  3. Select Image Size

    • Specify dimensions using the size parameter like “10241024” or “1280720”
    • Choose dimensions that match your use case (square for social media, widescreen for presentations, etc.)
  4. Configure Options

    • num_images: Set 1-9 to generate multiple variations
    • prompt_optimizer: Enable for automatic prompt enhancement
    • seed: Use for reproducible results
  5. Generate

    • Submit your request and receive generated images as URLs or Base64 strings

Character Reference Generation

For consistent character appearance:

  1. Prepare Portrait Photo

    • Use a clear, front-facing portrait with good lighting
    • Single person in frame works best
  2. Configure Character Reference

    • Use the subject_reference parameter with type “character”
    • Provide the portrait image URL or Base64 data
  3. 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

Also available on WaveSpeedAI:

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

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-Text description of the image, max length 1500 characters.
imagestringNo-Reference image file. Supports public URLs or Base64-encoded
sizestringNo1024*1024512 ~ 2048 per dimensionSpecify the width and height pixel values of the generated image.
num_imagesintegerNo11 ~ 9The number of images to generate.
seedintegerNo--1 ~ 2147483647Random seed. Using the same seed and parameters produces reproducible images. If not provided, a random seed is generated for each image.
prompt_optimizerbooleanNofalse-Enable automatic optimization of prompt.
enable_sync_modebooleanNofalse-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_outputbooleanNofalse-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

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.