Image
MiniMax H3 Image
최대 16개의 참조 이미지, 정확한 크기, 1–10개의 출력 및 토큰 기반 요금으로 이미지를 생성하고 편집합니다.
빠른 예제
이미지 요청 하나를 제출하고 반환된 id를 저장한 다음, 작업이 completed 또는 failed가 될 때까지 폴링합니다. 이 API는 비동기 작업을 사용하며 출력을 URL로 반환합니다.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"minimax-h3-image","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'엔드포인트 및 헤더
POST https://api.seedrouter.ai/v1/images/generations
| 헤더 | 값 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
키는 서버에 보관합니다. HTTP 성공 응답은 작업이 접수되었음을 나타내며, 이미지가 준비되었다는 뜻은 아닙니다.
매개변수
허용되는 필드는 13개입니다. model과 prompt만 필수입니다. 선택 필드를 생략하면 기본값을 사용하며, 어떤 필드도 null을 허용하지 않습니다. Playground는 고정된 모델과 편집 가능한 입력 항목 10개를 제공합니다. URL 응답 형식과 비스트리밍 작업 전달 방식은 고정되어 있습니다.
| 필드 | 유형 | 기본값 | 제약 조건 |
|---|---|---|---|
model | 문자열 | 필수 | minimax-h3-image |
prompt | 문자열 | 필수 | 앞뒤 공백 제거 후 유니코드 문자 1–32,000자 |
images | 객체 배열 | 생략 | 순서가 있는 객체 1–16개. 각 객체는 image_url을 포함합니다 |
disable_prompt_enhanced | 불리언 | false | 생성에만 적용. 아래 종속 조건을 참조합니다 |
n | 정수 | 1 | 1–10 |
size | 문자열 | auto | auto 또는 WIDTHxHEIGHT. 소문자 x를 사용합니다 |
aspect_ratio | 문자열 | auto | auto 또는 X:Y. X와 Y는 1–300의 정수이며 비율은 1:3–3:1입니다 |
area | 문자열 | 4K | 1K, 2K, 4K. 대략적인 목표 면적은 1,024², 2,048², 4,096²픽셀입니다 |
output_format | 문자열 | jpeg | jpeg, 별칭 jpg, png |
output_compression | 정수 | 95 | 0–100. JPEG 품질이며 PNG에서는 무시됩니다 |
aigc_watermark | 불리언 | false | AI 생성 콘텐츠 워터마크를 추가합니다 |
response_format | 문자열 | url | url만 허용합니다 |
stream | 불리언 | false | false만 허용합니다. 작업 ID로 폴링합니다 |
크기 및 프롬프트 종속 조건
size를 명시할 경우 양의 정수 크기를 포함해야 하며, 면적은 경계값을 포함하여 655,360–20,000,000픽셀이어야 합니다. 너비를 높이로 나눈 값은 1/3 이상 3 이하여야 합니다. 예를 들어 2048x1152는 유효합니다. 크기를 명시할 때는 값이 auto이더라도 aspect_ratio와 area를 모두 생략해야 합니다.
크기를 생략하거나 auto로 설정한 경우 aspect_ratio와 area를 함께 사용합니다. 면적은 목표 크기이므로 정확한 크기는 전달된 파일에서 확인합니다. 이는 이미지 한 장의 고정 요금을 의미하지 않습니다.
disable_prompt_enhanced: true를 설정하려면 명시적인 픽셀 크기 또는 고정된 가로세로 비율이 필요합니다. 향상 기능을 비활성화하면 모델은 프롬프트의 처음 약 4,096개 토큰을 읽습니다. 제출 시 32,000자 제한은 계속 적용됩니다. 편집 시에는 항상 프롬프트를 향상하므로 images가 있으면 true가 거부됩니다.
마스크, 시드, 스타일, 품질, 네거티브 프롬프트, 배경 또는 별도의 해상도 필드는 허용되지 않습니다. 알 수 없는 매개변수는 제출 전에 오류를 반환합니다. 이 API는 스트리밍, base64 이미지 및 WebP 출력을 제공하지 않습니다.
참조 이미지
자격 증명이 포함되지 않은 공개적으로 접근 가능한 HTTP(S) URL을 사용합니다. 각 이미지는 JPEG, PNG, WebP, HEIC 또는 HEIF 형식이어야 하며, 최대 64 MiB, 각 변 128–8,192픽셀, 긴 변과 짧은 변의 비율 최대 4의 조건을 충족해야 합니다. JSON 본문은 64 MiB 이하로 유지합니다. 이미지 파일은 URL로 참조하며 바이트 데이터는 JSON 본문에 포함하지 않습니다.
각 참조 이미지에 명확한 용도를 지정하고 변경하지 않아야 할 내용을 설명합니다. 배열 순서는 <Picture 1>, <Picture 2> 등에 해당합니다.
{
"model": "minimax-h3-image",
"prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
"images": [
{"image_url": "https://example.com/product.jpg"},
{"image_url": "https://example.com/setting.jpg"}
],
"aspect_ratio": "3:2",
"area": "2K",
"n": 1,
"output_format": "png"
}예시 URL을 접근 가능한 본인의 이미지 파일 URL로 바꿉니다.
요금
요금에는 텍스트 입력, 이미지 입력 및 이미지 출력의 세 가지 토큰 범주가 있습니다. 각 범주의 실제 사용량에 실시간 요율을 곱합니다. 출력 수, 이미지 크기 및 참조 이미지가 사용량에 영향을 미치며, 해상도 이름이 고정 청구 금액을 결정하지는 않습니다. 실패한 요청에는 요금이 부과되지 않습니다. 실시간 요금을 참조합니다.
작업 응답 및 폴링
접수된 요청은 비동기 작업을 반환합니다.
{"id":"task_example","model":"minimax-h3-image","status":"processing"}curl https://api.seedrouter.ai/v1/tasks/task_example \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"완료된 응답은 output.data에 이미지 URL을 포함합니다. 전달된 각 이미지에는 size가 포함되며, revised_prompt(향상된 설명)가 포함될 수도 있습니다. output.created는 Unix 초 단위의 생성 시각이며, output.output_format은 전달 형식을 나타냅니다. output.usage는 텍스트 입력, 이미지 입력 및 이미지 출력 토큰 수와 전달된 generated_images 수를 제공합니다. 아래 URL과 ID는 예시입니다.
{
"id": "task_example",
"model": "minimax-h3-image",
"status": "completed",
"output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}10–20초마다 폴링합니다. 클라이언트 시간 초과는 작업 실패를 의미하지 않습니다. 중복 요청을 제출하지 말고 ID를 보관하여 폴링을 계속합니다. 공개 응답에는 계정 잔액이나 비용이 포함되지 않습니다.
오류
HTTP 오류는 {"error":{"code":integer,"message":string}} 형식을 사용합니다. 실패한 작업에는 status: "failed"와 오류가 포함됩니다. 새로 제출하기 전에 잘못된 매개변수를 수정합니다. 공통 오류 목록 및 작업 수명 주기를 참조합니다.