image（Text-to-Image Generation）

Request

Authorization

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

Body Params application/json

model

string

required

Algorithm model ID for invocation. Available option: minimaxi-image-01

prompt

string

required

Description of the generated image. (Note: Must be less than 1500 characters)

aspect_ratio

string

required

Option to control the aspect ratio of the generated image. Available values: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9. Default is 1:1

response_format

string

required

Option to control the return format of the generated image. Either url or base64. Default is url, with a validity of 24 hours

prompt_optimizer

boolean

required

Controls whether prompt auto-optimization is enabled. Default is false

Example

{
  "model": "minimaxi-image-01",
  "prompt": "men Dressing in white t shirt, full-body stand front view image :25, outdoor, Venice beach sign, full-body image, Los Angeles, Fashion photography of 90s, documentary, Film grain, photorealistic",
  "aspect_ratio": "16:9",
  "response_format": "url",
  "prompt_optimizer": true
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.302.ai/minimaxi/v1/image_generation' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "minimaxi-image-01",
    "prompt": "men Dressing in white t shirt, full-body stand front view image :25, outdoor, Venice beach sign, full-body image, Los Angeles, Fashion photography of 90s, documentary, Film grain, photorealistic",
    "aspect_ratio": "16:9",
    "response_format": "url",
    "prompt_optimizer": true
}'

Responses

🟢200成功

application/json

Body

base_resp

object

required

Status codes and their details

status_code

integer

required

The status codes and their respective meanings are as follows:
0, Request successful
1002, Rate limit triggered, please try again later
1004, Account authentication failed, please check if the API-Key is filled in correctly
1008, Insufficient account balance
1026, Image description contains sensitive content
2013, Parameter exception, please check if the input parameters are filled in as required
2049, Invalid API key

status_msg

string

required

Specific error details.

data

object

required

Generated image result data

image_urls

array[string]

required

Link to the generated image.

image_base64

array[string]

required

Base64 encoding of the generated image.

id

string

required

metadata

object

required

Additional information about the generated image result

failed_count

string

required

Number of failed image generations.

success_count

string

required

Number of successful image generations

Example

{
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "data": {
    "image_urls": [
      "https://file.302ai.cn/gpt/imgs/ce313b3c9fcb6b436cfcdfd820690556.jpg"
    ]
  },
  "id": "041d88a669115ae5df49e4c6a5146325",
  "metadata": {
    "failed_count": "0",
    "success_count": "3"
  }
}