GPT-Image-2 이미지 생성

• 모델: gpt-image-2
• 엔드포인트: POST https://apimaster.ai/v1/images/generations
• 모드: 비동기 — task_id 반환 후 작업 폴링
• 기능: 텍스트-이미지; 최대 16개의 참조 이미지(URL + base64 혼합)를 사용한 이미지-이미지 변환

인증

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

본문 매개변수

필드	타입	필수	설명
model	string	예	gpt-image-2
prompt	string	예	장면 설명; 안전성 검사 적용
n	integer	아니요	1만 가능 (숫자, 따옴표 없음)
size	string	아니요	가로세로 비율, 기본값 1:1
resolution	string	아니요	1k / 2k / 4k, 기본값 1k
image_urls	array	아니요	참조 이미지 → 이미지-이미지 변환
official_fallback	boolean	아니요	공식 채널 폴백, 기본값 false

size 값

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, 또는 3840x2160과 같은 픽셀 문자열.

해상도 (샘플 픽셀)

크기	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

모든 15개 비율이 4K를 지원합니다.

image_urls

• 최대 16개 이미지
• 공개 URL과 base64 데이터 URI 혼합 가능
• size를 생략하면 입력 해상도를 따르고, size를 설정하면 출력 가로세로 비율을 강제합니다.

예제

최소 텍스트-이미지

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

제출 응답

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	의미
400	잘못된 매개변수
401	잘못된 API 키
402	잔액 부족
429	요청 제한 초과

작업 결과 폴링

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

이미지 URL: data.result.images[0].url[0]

상태	의미
submitted	대기 중
processing	실행 중
completed	완료
failed	오류 참조

10~20초 후 폴링, 3~5초 간격. 배치: POST https://apimaster.ai/v1/tasks/batch with {"task_ids":[...]}.

참고 사항

• 비동기 전용 — 생성 응답에 동기 이미지 URL이 없습니다.
• 가로세로 비율은 size를 선호하고, prompt에서 비율을 반복하지 마세요.
• 해상도 등급별 과금; 계정 콘솔을 확인하세요.

공식 채널과 비교하세요.