curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "바다 위의 화려하고 아름다운 석양"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax

MiniMax H3 Image 이미지 생성

MiniMax H3 Image (minimax-h3-image)는 텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 최대 16장의 참조 이미지를 입력할 수 있습니다
최대 2,000만 픽셀 출력: 화면 비율과 1K / 2K / 4K 해상도 단계를 조합하거나 너비와 높이를 픽셀로 직접 지정할 수 있습니다
비동기 처리: 반환된 작업 ID로 작업을 조회하세요
생성된 이미지 링크는 24시간 동안 유효합니다. 결과를 빠르게 저장하세요

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image",
  "prompt": "바다 위의 화려하고 아름다운 석양"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

인증

Authorization

string

header

필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

기본값:minimax-h3-image

필수

이미지 생성 모델 이름. 공식 채널은 안정성과 제어성이 뛰어나 상업적 용도에 적합합니다

사용 가능한 옵션:

minimax-h3-image

예시:

"minimax-h3-image"

prompt

string

필수

생성할 이미지 또는 입력 이미지의 편집 방법을 설명하는 프롬프트

길이 제한:

최대 32,000자 (유니코드 코드 포인트 기준)
prompt_extend가 false이면 프롬프트의 처음 약 4096개 토큰만 적용됩니다

Maximum string length: 32000

예시:

"바다 위의 화려하고 아름다운 석양"

image_urls

string<uri>[]

이미지 기반 생성 및 이미지 편집에 사용할 참조 이미지 URL 목록

참고:

요청당 입력 이미지 수: 1~16장
이미지당 최대 파일 크기: 64MB
각 이미지의 너비와 높이: 모두 128 ~ 8192 px
각 이미지의 화면 비율: 긴 변 / 짧은 변이 4:1 이하
지원 형식: .jpeg, .jpg, .png, .webp, .heic, .heif
이미지 URL은 서버에서 직접 접근할 수 있거나 접근 시 바로 다운로드되어야 합니다 (일반적으로 .png, .jpg 등의 이미지 확장자로 끝나는 URL)
이미지 기반 생성 및 편집 시 참조 이미지 자체에 추가 이미지 입력 토큰이 발생합니다

예시:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

size

string

기본값:auto

생성 이미지 크기. 화면 비율 또는 명시적 픽셀 크기를 지원합니다. 기본값: auto

① 화면 비율 (권장): X:Y. 자주 사용하는 비율:

1:1: 정사각형
1:2 / 2:1: 긴 세로 / 긴 가로
1:3 / 3:1: 매우 긴 세로 / 매우 긴 가로 (3:1 한계값)
2:3 / 3:2: 표준 세로 / 가로
3:4 / 4:3: 전통적인 세로 / 가로
4:5 / 5:4: 소셜 미디어에서 자주 사용하는 비율
9:16 / 16:9: 모바일 / 데스크톱 와이드 화면
9:21 / 21:9: 울트라와이드 형식

다른 X:Y 값도 지원합니다. X와 Y는 1 ~ 300 사이의 정수여야 하며, 화면 비율은 ≤ 3:1이어야 합니다

② 명시적 픽셀 크기: WxH (또는 W×H). 예: 1024x1024, 2720x1536, 5472x3072

총 픽셀 수: 655,360 ≤ width × height ≤ 20,000,000 (약 0.65 MP ~ 20 MP)
화면 비율: ≤ 3:1

③ auto: 모델이 화면 비율을 자동으로 결정하며, 출력 면적은 여전히 resolution 단계에 따릅니다

범위를 벗어난 크기:

위 범위를 벗어나면 400을 반환하며, 자동 크기 조정이나 반올림은 수행하지 않습니다

예시:

"auto"

resolution

enum<string>

기본값:2K

해상도 단계를 간편하게 지정하는 파라미터. size가 auto 또는 화면 비율일 때 적용되며, 명시적 픽셀 크기를 사용하면 무시됩니다

총 픽셀 수 규칙 (목표 총 픽셀 수와 size 비율로 너비와 높이를 계산):

1K: 약 1 MP (1024² = 1,048,576 픽셀)
2K: 약 4 MP (2048² = 4,194,304 픽셀)
4K: 약 16.8 MP (4096² = 16,777,216 픽셀)

가로 / 정사각형의 실제 출력 크기 (세로 크기는 해당 가로 크기의 너비와 높이를 바꾼 값입니다. 예: 3:4는 4:3의 반대):

화면 비율	2K	4K
`1:1`	2048×2048	4096×4096
`4:3`	2368×1760	4736×3552
`16:9`	2720×1536	5472×3072
`3:1`	3552×1184	7104×2368

참고:

1K와 2K의 이미지 출력 토큰 수는 동일합니다 (이미지당 약 4,096개). 4K는 이미지당 약 16,384개이며, 반환된 usage가 기준입니다
값은 대소문자를 구분하지 않습니다

사용 가능한 옵션:

1K,

2K,

4K

예시:

"2K"

output_format

enum<string>

기본값:jpeg

출력 이미지 파일 형식. 기본값: jpeg

jpeg: 손실 압축으로 파일 크기가 작음
png: 무손실
webp: 파일 크기와 품질의 균형

참고:

투명 배경은 지원하지 않습니다

사용 가능한 옵션:

jpeg,

png,

webp

예시:

"jpeg"

integer

기본값:1

생성할 이미지 수. 각 이미지는 개별 과금됩니다

참고:

텍스트 입력 토큰과 이미지 입력 토큰 모두 n에 비례하여 증가합니다
일부 이미지가 실패하더라도 (예: 콘텐츠 안전 검사) 성공한 이미지를 포함하여 작업이 완료됩니다. 실제 이미지 수는 응답의 results를 따르며, 과금은 반환된 usage를 기준으로 정산됩니다

필수 범위: 1 <= x <= 10

예시:

1

prompt_extend

boolean

기본값:true

프롬프트 최적화: 생성 전에 모델이 프롬프트를 더 상세하게 다시 작성합니다. 기본값: true

참고:

텍스트 기반 이미지 생성이며 size가 화면 비율 또는 명시적 픽셀 크기일 때만 false로 설정할 수 있습니다
size가 auto이거나 image_urls가 제공된 경우 false로 설정하면 400을 반환합니다
활성화하면 이미지당 약 2,300 ~ 3,800개의 텍스트 입력 토큰이 추가되며, 비활성화하면 원래 프롬프트만 계산됩니다

예시:

true

callback_url

string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 타이밍:

작업이 완료, 실패 또는 취소될 때 트리거됨
과금 확인 완료 후 전송

보안 제한:

HTTPS 프로토콜만 지원
내부 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
URL 길이는 2048자를 초과할 수 없음

콜백 메커니즘:

타임아웃: 10초
실패 시 최대 3회 재시도 (1초/2초/4초 후 재시도)
콜백 응답 본문 형식은 작업 조회 API 응답 형식과 동일
콜백 주소가 2xx 상태 코드를 반환하면 성공으로 간주, 다른 상태 코드는 재시도를 트리거

예시:

"https://your-domain.com/webhooks/image-task-completed"

응답

이미지 작업이 성공적으로 생성되었습니다

created

integer

작업 생성 타임스탬프

예시:

1757156493

string

작업 ID

예시:

"task-unified-1757156493-imcg5zqt"

model

string

실제 사용된 모델 이름

예시:

"minimax-h3-image"

object

enum<string>

구체적인 작업 유형

사용 가능한 옵션:

image.generation.task

progress

integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"pending"

task_info

object

비동기 작업 정보

Show child attributes

type

enum<string>

작업 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"image"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

MiniMax H3 Image 이미지 생성

인증

본문

응답