curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "한 마리의 주황색 고양이가 창턱에 앉아 석양을 바라보는 수채화 스타일",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

GPT-Image-2

GPT-Image-2 이미지 생성

비동기 처리 모드, 작업 ID를 반환하여 이후 조회에 사용
OpenAI Images 호환 프로토콜 기반, 텍스트 생성 이미지 / 이미지 변환 지원
13가지 이미지 비율 지원, aspect_ratio 필드로 전달
resolution 단계 필드 추가, 1K / 2K / 4K 해상도 선택 지원(4K 전 비율 지원)
size 필드 추가, 사용자 정의 픽셀 크기 지원(aspect_ratio / resolution과 상호 배타적, 총 픽셀 수 ≥ 2,088,960이어야 정확한 이미지 생성 가능)
참조 이미지는 최대 10장, URL과 base64 혼용 가능
제출된 prompt는 플랫폼 민감어 / 보안 심사를 통과하며, 위반 내용은 즉시 거부됨

POST

api

openapi

submit

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "한 마리의 주황색 고양이가 창턱에 앉아 석양을 바라보는 수채화 스타일",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

Authorizations

Authorization

string

필수

모든 API는 Bearer Token을 사용하여 인증해야 합니다.API Key 받기:API Key 관리 페이지에 접속하여 API Key를 받으세요.요청 헤더에 다음을 추가하세요:

Authorization: Bearer YOUR_API_KEY

Body

model

string

필수

모델 이름고정 값: "gpt_image_2"

params

object

필수

모델 파라미터 객체

표시 params 객체 속성

prompt

string

필수

이미지 생성을 위한 텍스트 설명

한중영 지원, 자세한 설명 권장
제출 전 플랫폼 민감 단어 / 보안 검토 진행, 위반 내용 적발 시 오류 반환

image_url

string[]

참조 이미지 배열, 전달 시 이미지 생성 모드로 동작

최대 10장의 참조 이미지
다음 두 가지 형식 지원:
1. 공개 접근 가능한 URL
2. Base64 인코딩 형식
  - 반드시 완전한 Data URI 형식 사용: data:image/{형식};base64,{base64데이터}
  - 지원 이미지 형식: jpeg, png, webp
  - 예시: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  - ⚠️ 주의: 반드시 data:image/jpeg;base64, 접두어 포함

aspect_ratio

string

기본값:"auto"

이미지 생성 비율기본값은 resolution에 따라 변동:

resolution이 1K / 2K일 때 미전달 시 기본값 auto
resolution이 4K일 때 미전달 시 기본값 16:9

다음 값 지원:

auto - 가장 적합한 비율 자동 선택
1:1 - 정사각형
16:9 / 9:16 - 와이드 가로 / 세로
4:3 / 3:4 - 표준 가로 / 세로
3:2 / 2:3 - 클래식 가로 / 세로
5:4 / 4:5 - 근사 정사각형 가로 / 세로
2:1 / 1:2 - 와이드 가로 / 롱 세로
21:9 / 9:21 - 초와이드 가로 / 초롱 세로

비율은 문자열 또는 auto만 지원; 픽셀 크기(예: 1024x1024) 전달 시 오류

resolution

string

기본값:"1K"

해상도 단계실제 이미지 선명도 제어:

1K - 1024 기준, 비용 절감 일상용(기본값)
2K - 2048 기준, 포스터 / 고해상도 필요에 적합
4K - 3840 기준, 모든 13가지 비율 지원

size 전달 시, resolution과 aspect_ratio 동시에 전달 불가, 400 반환

size

string

사용자 정의 픽셀 크기 (aspect_ratio / resolution과 상호 배타적)형식은 가로x세로, 예: 2048x1536, 3840x2160.사용 제한:

형식은 반드시 ^\d+x\d+$ (예: 2048x1536), 다른 작성법은 미지원
aspect_ratio, resolution과 상호 배타적, 세 개 중 하나만 선택; 동시에 전달 시 400 오류
총 픽셀 수(가로 × 세로)는 655,360 ~ 8,294,400 범위여야 함

실제 픽셀 하한:

총 픽셀 범위	상위 시스템 동작
≥ 2,088,960 (약 2.0M)	입력한 `size`에 따라 정확히 출력 ✅
< 2,088,960	약 1.57M 비슷한 비율로 조용히 대체(즉, `size` 미전달과 동일) ⚠️

총 픽셀이 약 2,088,960 이하일 경우, 상위 시스템은 오류를 내지 않으나 출력 크기를 조용히 변경함. 정확한 제어가 필요하면 총 픽셀 수 ≥ 2,088,960 권장.낮은 크기 필요 시 aspect_ratio + resolution=1K 조합 사용 권장.

선택 권장:

요구사항	추천 방식
픽셀 크기 정확 제어	`size`, 그리고 총 픽셀 수 ≥ 2,088,960
작은 크기(< 2M 픽셀)	`aspect_ratio` + `resolution=1K`
중대형 임의 비율	`size`, 2K / 4K 범위에서 임의 비율 정확 출력 가능

out_task_id

string

필수

요청자 작업 ID사용자 정의 작업 식별자, 필수

크기 × 해상도 매핑 테이블

aspect_ratio × resolution → 실제 픽셀 (13 비율 × 3 단계):

aspect_ratio	`1K`	`2K`	`4K`
`1:1`	1024×1024 / 1254×1254	2048×2048	2880×2880
`3:2`	1536×1024	2048×1360	3520×2336
`2:3`	1024×1536	1360×2048	2336×3520
`4:3`	1024×768	2048×1536	3312×2480
`3:4`	768×1024	1536×2048	2480×3312
`5:4`	1280×1024 / 1448×1086	2560×2048	3216×2576
`4:5`	1024×1280 / 1122×1402	2048×2560	2576×3216
`16:9`	1536×864 / 1672×941	2048×1152	3840×2160
`9:16`	864×1536 / 941×1672	1152×2048	2160×3840
`2:1`	2048×1024 / 1774×887	2688×1344	3840×1920
`1:2`	1024×2048 / 887×1774	1344×2688	1920×3840
`21:9`	2016×864 / 1915×821	2688×1152	3840×1648
`9:21`	864×2016 / 821×1915	1152×2688	1648×3840

3:2 / 2:3 @ 2K는 실제로 2048×1360 (근사 비율, 오차 < 0.5%); 4K는 이제 모든 13개 비율을 지원합니다.

사용자 정의 크기(size 매개변수)

픽셀 크기를 정확히 제어해야 할 때, aspect_ratio + resolution 조합 대신 size 매개변수를 사용할 수 있습니다. 유효 범위: 총 픽셀 655,360 ~ 8,294,400(상위 공식 제한) 실제 유효 하한: 총 픽셀 ≥ 2,088,960(약 1440×1452 또는 2048×1020 동등 면적) 이 하한 미만에서는 상위에서 오류를 반환하지 않지만, 조용히 약 1.57M 픽셀 크기의 비슷한 비율로 대체됩니다.

자주 사용하는 size 예시

size 값	총 픽셀	추천 용도
`2048x2048`	4,194,304	정사각형 고해상도
`2048x1536`	3,145,728	4:3 가로형
`1536x2048`	3,145,728	3:4 세로형
`2048x1152`	2,359,296	16:9 가로형
`1152x2048`	2,359,296	9:16 세로형
`3840x2160`	8,294,400	4K 16:9(최상위)
`2688x1344`	3,612,672	2:1 와이드 가로형

aspect_ratio나 resolution과 동시에 전달하지 마십시오, 그렇지 않으면 400을 반환합니다.

Response

out_task_id

string

요청자 작업 ID로 결과 조회에 사용할 수 있음

status

string

초기 상태, 고정 값 "pending"

estimated_credits

number

예상 소모 크레딧

created_at

string

생성 시간(ISO 형식)

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "한 마리의 주황색 고양이가 창턱에 앉아 석양을 바라보는 수채화 스타일",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

GPT-4o 이미지 생성 GPT-Image-2 공식 채널 이미지 생성

Documentation Index

​Authorizations

​Body

​크기 × 해상도 매핑 테이블

​사용자 정의 크기(size 매개변수)

​자주 사용하는 size 예시

​Response

Authorizations

Body

크기 × 해상도 매핑 테이블

사용자 정의 크기(size 매개변수)

자주 사용하는 size 예시

Response