이미지 생성

POST/v1/images/generations

텍스트 프롬프트로 이미지를 생성합니다.

인증

bearerAuth

인증Bearer <token>

플랫폼 API Key를 Authorization: Bearer your-api-key 형식으로 사용하세요.

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

플랫폼 모델 ID.

prompt*string

이미지 생성 또는 편집 프롬프트. 앞뒤 공백을 제외한 Unicode 문자 수로 계산하며 공백만 입력할 수 없습니다.

길이1 <= length <= 32000

n?integer

생성할 이미지 수.

범위1 <= value <= 10

기본값1

size?string

auto 또는 WIDTHxHEIGHT, 기본값은 auto입니다. 사용자 지정 면적은 655,360–20,000,000픽셀, 가로세로 비율은 1:3–3:1입니다. 너비와 높이를 지정할 때 aspect_ratio와 area를 생략하세요.

기본값"auto"

aspect_ratio?string

기본값은 auto이며 보강된 프롬프트와 편집 시 참조 이미지로 결정합니다. X:Y도 가능하며 X와 Y는 1–300의 정수, 비율은 1:3–3:1입니다. size가 생략되거나 auto일 때만 사용합니다.

area?string

면적 단계, 기본값은 4K입니다. size가 생략되거나 auto일 때만 사용하며 실제 크기는 data[].size에 반환됩니다.

허용 값

"1K"
"2K"
"4K"

output_format?string

이미지 형식. jpg와 jpeg는 동일하며 응답은 jpeg를 사용합니다.

기본값"jpeg"

허용 값

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url 링크 유효 기간은 24시간입니다. b64_json은 Base64를 반환하며 스트리밍을 지원하지 않습니다. Base64 총 출력 면적은 PNG 20,000,000픽셀, JPEG/WebP 80,000,000픽셀이며 모든 이미지를 합산합니다.

기본값"url"

허용 값

"url"
"b64_json"

output_compression?integer

JPEG/WebP 압축 품질. 값이 높을수록 파일이 커집니다. PNG에서는 무시합니다.

범위0 <= value <= 100

기본값95

stream?boolean

SSE로 이미지별 결과를 반환할지 여부. response_format이 url인 경우만 지원합니다.

기본값false

aigc_watermark?boolean

표시되는 AIGC 워터마크를 추가할지 여부. 파일 메타데이터의 비가시적 식별자에는 영향을 주지 않습니다.

기본값false

disable_prompt_enhanced?boolean

프롬프트 보강을 끌지 여부. 끄면 약 처음 4,096 Token만 적용되며 구체적인 size 또는 고정 aspect_ratio가 필요합니다.

기본값false

응답 본문

`application/json`

type*string

created?integer

이벤트의 Unix 타임스탬프.

model?string

실제로 사용한 모델 ID.

image_index*integer

0부터 시작하는 이미지 인덱스.

범위0 <= value

url*string

생성 이미지의 임시 링크.

size?string

실제 이미지 WIDTHxHEIGHT.

output_format?string

실제 출력 형식.

허용 값

"jpeg"
"png"
"webp"

revised_prompt?string

해당 이미지에 사용한 프롬프트.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "밝은 벽을 배경으로 나무 테이블 위에 놓인 녹색 탁상등 사진을 생성해 주세요. 부드러운 자연광을 사용해 주세요.",
    "size": "2048x2048",
    "n": 1,
    "response_format": "url"
  }'

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "밝은 벽 앞 나무 테이블에 녹색 탁상등이 놓여 있고 부드러운 자연광이 갓과 테이블을 비춥니다."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

클라이언트 시간 제한은 600초 이상을 권장합니다. 시간 초과 또는 연결 종료 후에도 서버에서 생성이 계속될 수 있으며 다시 전송하면 새 요청이 생성됩니다.

MiniMax 이미지 생성 API요청 매개변수와 응답 구조를 확인합니다.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

스트리밍 응답 이벤트

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`