레퍼런스v1.0.0 안정 버전

AI Image 2 API

GPT Image 2.0 이미지 생성 및 참조 기반 편집을 통합하세요. 인증, generate / status 엔드포인트, 요청 제한, 과금을 다룹니다.

https://gptimage2-ai.com

퀵 스타트

생성 작업을 제출하고 상태를 폴링하는 두 단계만으로 첫 번째 API 호출을 완료할 수 있습니다.

작업 제출

POST 요청을 generate 엔드포인트로 보내 Task ID를 받습니다.

상태 조회

Task ID를 사용해 진행 상황을 확인하고, 이미지 URL이 반환될 때까지 조회합니다.

인증

주의: API 키는 안전하게 보관하고, 클라이언트 사이드 코드에 노출하지 마세요.

HTTP 헤더

Authorization: Bearer {YOUR_API_KEY}

POST

https://gptimage2-ai.com/api/generate

새 이미지 생성 또는 참조 편집 작업을 생성합니다. 이 엔드포인트는 비동기이며 task_id와 초기 상태를 반환합니다. 최종 이미지는 /api/status로 조회하세요.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

본문 파라미터

파라미터 이름	타입	필수 여부	설명
`prompt`	string	조건부	만들 이미지를 설명하는 텍스트 프롬프트(최대 20000자). images가 비어 있으면 필수입니다.
`images`	string[]	아니요	순수 텍스트-이미지 생성 대신 편집·재구성에 사용할 참조 이미지 URL 배열(선택).
`aspect_ratio`	string	아니요	출력 화면 비율. 허용 값: auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3.
`resolution`	string	아니요	출력 해상도: 1K(기본), 2K, 4K. 5:4와 4:5는 1K만 지원, 1:1은 4K 미지원.

응답(JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://gptimage2-ai.com/api/status

작업의 실행 상태와 결과를 조회합니다.

쿼리 파라미터

파라미터 이름	필수 여부	설명
`task_id`	필수	작업을 제출할 때 반환된 ID입니다.

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0"
    ],
    "consumed_credits": 10,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

결제

이미지당 비용

10 크레딧 / 장

실패한 작업은 과금되지 않습니다. 사이트 내 다른 모델은 별도 요율을 사용합니다.

오류 처리

401 Unauthorized유효하지 않은 API 키입니다.
402 Payment Required잔액이 부족합니다.
429 Too Many Requests요청 한도에 도달했습니다.

GPT Image 2.0 소개

GPT Image 2.0은 AI Image 2를 구동하는 이미지 모델입니다. AI Image 2는 독립 서비스이며 OpenAI와 제휴·보증·후원 관계가 없습니다.

GPT Image 2.0 — 프롬프트를 정확히 따르고 이미지 속 텍스트가 읽기 쉬운 생성

GPT Image 2.0은 세부 지시를 충실히 따르고 이미지 안에 읽기 쉬운 텍스트를 렌더링하며, 참조 사진을 받아 기존 이미지를 편집할 수 있습니다.

타이포그래피, 레이아웃, 참조 편집에 최적화

텍스트 가독성이 중요한 포스터, 인포그래픽, UI 목업에 강하고, 참조 이미지를 제공하면 스타일이나 배경을 바꿔도 피사체를 유지합니다.

강점

읽기 쉬운 이미지 내 텍스트 — 포스터와 인포그래픽 안의 헤드라인, 라벨, 짧은 슬로건을 렌더링합니다.
참조 기반 편집 — 이미지 URL을 전달해 피사체를 유지하면서 사진의 스타일 변경이나 재구성이 가능합니다.
구조화된 레이아웃 — 메뉴, 전단지, 스토리보드처럼 정렬된 패널이 있는 다중 요소 구성을 처리합니다.
1K~4K 출력 — 1K, 2K, 4K 선택 가능. 1:1은 4K 미지원, 5:4 / 4:5는 1K만 지원.
11가지 화면 비율 — auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3.
정액 요금 — 이미지당 10 크레딧, 작업 성공 시에만 차감됩니다.

사용 방법

promptprompt — 자연어 설명. 렌더링할 정확한 문구를 포함하세요(최대 20000자).
imagesimages — 참조 이미지 URL 배열(선택). 모델이 이를 편집하거나 재구성합니다.
resolutionresolution — 1K(기본), 2K, 4K. 모든 크기가 동일하게 10 크레딧입니다.

GPT Image 2 prompts Examples