MiniMax의 첫 이미지 생성 모델로 캐릭터 레퍼런스를 지원합니다. subject_reference에 얼굴 사진 한 장만 넣으면 프롬프트·스타일·화면 비율이 바뀌어도 동일 인물을 일관되게 생성하며, 요청당 최대 9장까지 만들 수 있습니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/image-01",
"input": {
"prompt": "A close-up portrait of a leopard with distinctive spotted pattern and intense eyes",
"aspect_ratio": "3:4",
"number_of_images": 1,
"prompt_optimizer": true
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 이미지 생성을 위한 텍스트 프롬프트 |
subject_reference | string | No | - | 생성 이미지의 주인공으로 사용할 캐릭터 레퍼런스 이미지 (사람 얼굴) |
aspect_ratio | string | No | 1:1 | 이미지 화면 비율 1:116:94:33:22:33:49:1621:9 |
number_of_images | integer | No | 1 | 생성할 이미지 수 (1~9장). 장수만큼 과금됨 |
prompt_optimizer | boolean | No | true | 프롬프트 옵티마이저 사용 여부 |
이 모델의 subject_reference 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=minimax/image-01" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:subject_reference=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "minimax/image-01",
"input": {
"prompt": "your prompt here",
"subject_reference": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
기본 프롬프트 옵티마이저를 사용한 텍스트-이미지 포트레이트
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/image-01",
"input": {
"prompt": "A close-up portrait of a leopard with distinctive spotted pattern and intense eyes",
"aspect_ratio": "3:4",
"number_of_images": 1,
"prompt_optimizer": true
}
}'subject_reference로 생성 변형 전반에 걸쳐 동일 인물을 유지
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/image-01",
"input": {
"prompt": "A professional studio portrait, soft lighting, navy suit, confident smile",
"subject_reference": "https://example.com/face.jpg",
"aspect_ratio": "3:4",
"number_of_images": 4
}
}'