curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "별이 빛나는 밤하늘 아래의 오래된 성",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

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

GPT-Image-2

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

OpenAI 공식 gpt-image-2 모델, /v1/images/generations 호환 프로토콜 기반
비동기 처리 모드, 후속 조회를 위한 task_id 반환
텍스트 생성 이미지 / 이미지 변환 이미지 통합 지원
resolution 레벨 필드 추가, 1K / 2K / 4K 해상도 선택 지원
13가지 비율 지원(4K 레벨은 6가지: 16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21)
참조 이미지는 최대 9장, 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_official",
    "params": {
      "prompt": "별이 빛나는 밤하늘 아래의 오래된 성",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

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

Authorizations

Authorization

string

필수

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

Authorization: Bearer YOUR_API_KEY

Body

model

string

기본값:"gpt_image_2_official"

필수

이미지 생성 모델 이름gpt_image_2_official (OpenAI 공식 gpt-image-2 모델)로 고정 작성

params

object

필수

모델 파라미터 객체

표시 params 객체 속성

prompt

string

필수

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

한글과 영어 지원, 자세히 설명하는 것을 권장
제출 전 플랫폼 민감 단어 / 안전성 검사를 거치며, 위반 내용이 있으면 오류를 즉시 반환

aspect_ratio

string

기본값:"1:1"

화면 비율외부에는 비율 값만 사용하며, 시스템 내부에서는 resolution에 따라 픽셀로 자동 매핑13가지 비율 지원:

1:1 - 정사각형 구성 (기본, 소셜 프로필 사진 / 로고)
3:2 - 가로 구성 (DSLR 카메라 일반 비율)
2:3 - 세로 구성 (포스터 세로형)
4:3 - 가로 구성 (전통 모니터 / PPT)
3:4 - 세로 구성
5:4 - 가로 구성
4:5 - 세로 구성 (인스타그램 세로 게시물)
16:9 - 가로 구성 (와이드 영상 표지)
9:16 - 세로 구성 (휴대폰 전체 화면 / 짧은 영상 표지)
2:1 - 가로 구성 (웹 배너)
1:2 - 세로 구성
21:9 - 가로 구성 (영화 울트라 와이드)
9:21 - 세로 구성

비율 형식만 지원하며, 픽셀 크기(예: 1024x1024)를 입력하면 오류 발생

resolution

string

기본값:"1K"

해상도 단계실제 생성 이미지 해상도 조절:

1K - 1024 기준, 경제적이며 일상용으로 충분 (기본값)
2K - 2048 기준, 포스터 / 고화질 요구에 적합
4K - 3840 기준, 6개 비율만 지원(16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21)

지원하지 않는 4K 조합은 400 오류 반환:

1:1 × 4K ❌ (초과 픽셀 한도)
3:2 / 2:3 × 4K ❌ (초과 픽셀 한도)
4:3 / 3:4 × 4K ❌ (초과 픽셀 한도)
5:4 / 4:5 × 4K ❌ (초과 픽셀 한도)

위 비율에 고화질을 원할 시 resolution=2K로 변경

quality

string

기본값:"low"

이미지 품질

low - 빠르고 경제적, 윤곽만 충분 (기본값)
medium - 균형 잡힌 품질
high - 최고의 정밀도 (4K + high는 120초 이상 소요)

image_url

array

참고 이미지 배열, 입력 시 이미지 기반 생성 모드로 동작

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

out_task_id

string

필수

발신자 작업 ID사용자가 정의하는 작업 식별자, 필수 입력

크기 × 해상도 매핑 표

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

aspect_ratio	`1K`	`2K`	`4K`
`1:1`	1024×1024	2048×2048	❌ 초과 픽셀 한도
`3:2`	1536×1024	2048×1360	❌ 초과 픽셀 한도
`2:3`	1024×1536	1360×2048	❌ 초과 픽셀 한도
`4:3`	1024×768	2048×1536	❌ 초과 픽셀 한도
`3:4`	768×1024	1536×2048	❌ 초과 픽셀 한도
`5:4`	1280×1024	2560×2048	❌ 초과 픽셀 한도
`4:5`	1024×1280	2048×2560	❌ 초과 픽셀 한도
`16:9`	1536×864	2048×1152	3840×2160
`9:16`	864×1536	1152×2048	2160×3840
`2:1`	2048×1024	2688×1344	3840×1920
`1:2`	1024×2048	1344×2688	1920×3840
`21:9`	2016×864	2688×1152	3840×1648
`9:21`	864×2016	1152×2688	1648×3840

3:2 / 2:3 @ 2K 실제는 2048×1360(근사 비율, 오차 < 0.5%); 4K는 6개 비율만 지원(전체 픽셀 OpenAI 한도 초과 조합은 사용 불가).

Response

code

integer

응답 상태 코드

data

array

반환 데이터 배열

표시 속성

status

string

작업 상태

submitted - 제출됨

task_id

string

작업 고유 식별자, 후속 작업 결과 조회에 사용됨

작업 결과 조회

제출이 성공하면 task_id가 반환되며, GET /v1/tasks/{task_id}를 통해 작업 상태를 폴링하여 확인할 수 있습니다. 자세한 내용은 작업 조회 API를 참조하세요.

폴링 권장사항

최초 조회 지연: 제출 후 10~20초 대기 후 조회 시작 권장
조회 간격: 3~5초마다 한 번 권장
타임아웃 참고: high + 2K/4K 조합 작업은 최대 130초 소요될 수 있으니 클라이언트 타임아웃을 180초 이상으로 설정 권장

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "별이 빛나는 밤하늘 아래의 오래된 성",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

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

GPT-Image-2 이미지 생성 Seedream V4 이미지 생성

Documentation Index

​Authorizations

​Body

​크기 × 해상도 매핑 표

​Response

​작업 결과 조회

​폴링 권장사항

Authorizations

Body

크기 × 해상도 매핑 표

Response

작업 결과 조회

폴링 권장사항