curl --request POST \
  --url https://api.modellix.ai/api/v1/minimax/minimax-image-01-i2i \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A girl in futuristic style",
  "subject_reference_images": [
    "https://example.com/reference.jpg"
  ]
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'subject_reference_images' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 10 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

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.

POST

minimax

minimax-image-01-i2i

curl --request POST \
  --url https://api.modellix.ai/api/v1/minimax/minimax-image-01-i2i \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A girl in futuristic style",
  "subject_reference_images": [
    "https://example.com/reference.jpg"
  ]
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'subject_reference_images' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 10 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

prompt

string

required

Image description text, supports Chinese and English

Required string length: 1 - 1500

Example:

"A girl in futuristic style"

subject_reference_images

string[]

required

Reference image URLs for image-to-image generation. Supports public HTTPS URLs or Base64 Data URLs

Required array length: 1 - 10 elements

Image URL or Base64 Data URL (data:image/jpeg;base64,...). Image requirements: JPG/JPEG/PNG format, <10MB, best with single front-facing portrait photo

Example:

["https://example.com/reference.jpg"]

aspect_ratio

enum<string>

default:1:1

Image aspect ratio. If both aspect_ratio and width/height are provided, aspect_ratio takes priority

Available options:

1:1,

16:9,

4:3,

3:2,

2:3,

3:4,

9:16,

21:9

Example:

"1:1"

width

integer

Image width in pixels (must be used with height). Must be divisible by 8. If aspect_ratio is provided, width/height will be ignored

Required range: 512 <= x <= 2048

Example:

1024

height

integer

Image height in pixels (must be used with width). Must be divisible by 8. If aspect_ratio is provided, width/height will be ignored

Required range: 512 <= x <= 2048

Example:

1024

seed

integer

Random seed for reproducible results. Use the same seed with same parameters to generate identical images

Required range: x >= 0

Example:

42

integer

default:1

Number of images to generate per request

Required range: 1 <= x <= 9

Example:

1

prompt_optimizer

boolean

default:false

Enable automatic prompt optimization to improve generation quality

Example:

false

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Minimax i2v 01 live Minimax image 01 live i2i