Bearer token 으로 gpt-image-2 API 를 호출하면 약 45초 만에 호스팅 PNG 를 받을 수 있습니다. 텍스트-투-이미지와 이미지-투-이미지는 동일한 엔드포인트를 공유합니다. 이미지당 2 크레딧이며 최소 결제 약정이나 SDK 설치가 필요 없습니다. 커피가 도착하기 전에 키를 발급받고 첫 curl 렌더링을 실행해 보십시오.
이미 사용 중인 개발자 10,000명 이상 명의 개발자가 gpt-image-2 API 로 제품을 출시하고 있습니다
단일 엔드포인트. Bearer 인증. 호스팅 출력. 추가 연결 작업이 필요 없습니다.
gpt-image-2 API 는 prompt (그리고 최대 4장의 reference images) 를 프로덕션 수준의 PNG 로 변환하는 REST 인터페이스입니다. Bearer token 과 함께 /api/v1/images/generate 에 POST 하면 task_id 를 받게 되며, 이후 /api/v1/images/task/[id] 를 폴링하여 이미지 준비 완료 여부를 확인합니다. 모든 응답은 JSON 입니다 — 2xx 에서는 성공 엔벨로프, 4xx 및 5xx 에서는 안정적인 code 와 request_id 를 담은 오류 엔벨로프가 반환됩니다. 모든 렌더링 결과물은 자사의 R2 CDN 에 저장되어 HTTPS 로 제공되므로, URL 을 직접 핫링크하거나 자체 버킷으로 미러링할 수 있습니다. 크레딧은 제출 시점에 원자적으로 차감되며 작업이 실패하면 자동으로 환불되므로 실제 산출물과 과금이 어긋날 일이 없습니다. 이 인터페이스는 사용자 범위로 한정됩니다: 키는 소유 계정의 크레딧 잔액을 상속하며, 웹 스튜디오에서 생성한 작업이 아닌 프로그래밍 방식으로 생성한 작업만 조회할 수 있습니다. 보내는 모든 것은 JSON 입니다 — multipart 업로드, SDK 종속성, 숨겨진 재시도 로직이 없습니다.
POST /api/v1/images/generate 하나로 gpt-image-2 API 의 텍스트-투-이미지와 이미지-투-이미지를 모두 처리합니다. reference images 를 포함하면 모드가 자동 전환되며 나머지 요청 본문은 동일합니다.
Authorization: Bearer YOUR_API_KEY 로 인증합니다. gpt-image-2 API 는 query string 에 담긴 키를 거부하므로 token 이 CDN 이나 프록시 로그에 유출될 위험이 없습니다.
완료된 모든 gpt-image-2 API 작업은 안정적인 https://file.gptimg.co URL 을 반환합니다. 서명된 URL 의 만료, 다운로드 후 재호스팅 작업, 임시 링크가 없습니다.
gpt-image-2 API 는 정사각형, 세로형, 가로형, 와이드스크린, 울트라와이드를 모두 지원합니다. 플랫폼에 필요한 비율을 선택해 바로 출시하십시오. 생성 이후의 레터박싱 작업이 필요 없습니다.
gpt-image-2 API 가 실패한 작업을 반환하면 차감된 크레딧이 자동으로 환불됩니다. 정산 스크립트를 따로 만들 필요가 없습니다.
성공이든 오류든 모든 gpt-image-2 API 응답에는 X-Request-Id 헤더와 본문에 일치하는 request_id 가 포함됩니다. 지원 티켓이 며칠이 아닌 몇 분 안에 해결됩니다.
단일 prompt 엔드포인트, 구축할 인프라 없음, 재무 팀에 설명 가능한 과금 구조
GPU 팟을 프로비저닝하거나 벤더 계약을 협상하지 않고도 새 이미지 기능을 출시할 수 있습니다. gpt-image-2 API 는 렌더링당 정액 요금제입니다 — 1:1 이미지 기준 2 크레딧이며 batch 크기에 따라 선형으로 증가합니다. 클라이언트를 단 한 번의 HTTP 호출로 백엔드에 연결하고, 기능을 플래그 뒤에 배치한 뒤 사용량을 보며 가격 포인트를 찾으면 됩니다. 많은 팀이 아이디어에서 스테이징까지 반나절 안에 도달합니다.
최대 4장의 레퍼런스를 지원하는 이미지-투-이미지, 모두 동일한 엔드포인트에서 처리
reference_images 에 1–4개의 https URL 을 전달하면 gpt-image-2 API 가 자동으로 이미지-투-이미지 모드로 전환됩니다. 스타일 전이, 리스타일, 제품 교체, 아이덴티티 보존 편집에 자주 활용됩니다. 별도의 편집 엔드포인트나 multipart form, base64 팽창이 없습니다 — http(s) URL 만 허용되므로 요청 본문은 작고 로그는 가독성 있게 유지됩니다.
안정적인 오류 code, request_id 상관관계, 공급자 정보를 숨긴 메시지
모든 gpt-image-2 API 응답에는 지원 티켓에 인용할 수 있는 request_id 가 포함됩니다. 오류는 error.code, error.message, error.request_id 필드를 가진 일관된 엔벨로프를 따릅니다. 소수의 안정적인 code 가 모든 실패 시나리오를 포괄합니다 — UNAUTHORIZED, INVALID_REQUEST, INSUFFICIENT_CREDITS, NOT_FOUND, RATE_LIMITED, INTERNAL_ERROR. 상위 공급자의 이름은 모든 메시지에서 제거되므로, 문제가 발생해도 클라이언트에 벤더 내부 정보가 노출되지 않습니다.
정액 크레딧, R2 미러링, 두 모드를 모두 지원하는 단일 인터페이스
gpt-image-2 API 는 렌더링당 하나의 정액 크레딧 가격, 24시간 내 만료되지 않는 호스팅 PNG URL, 그리고 텍스트-투-이미지와 이미지-투-이미지를 모두 포괄하는 단일 엔드포인트를 제공합니다. OpenAI 의 images 엔드포인트를 통해 동일한 이미지를 생성하면 크기와 품질에 따라 $0.01–$0.20 이 청구되고, 다운로드 후 재호스팅해야 하는 임시 서명 URL 이 제공됩니다. n=4 로 배치를 구성해도 선형 크레딧만 지불하면 됩니다 — 별도의 엔드포인트, 숨겨진 품질 등급 요금, 좌석당 라이선스가 없습니다.
네 단계. 첫 curl 까지 5분 이내.
로그인한 뒤 Settings → API Keys 로 이동해 Create 를 클릭하고 평문 키를 한 번에 복사합니다. gpt-image-2 API 는 키를 생성 시점에만 보여주므로, 반드시 시크릿 매니저에 저장해야 합니다.
prompt, aspect_ratio, n, 그리고 선택 사항인 reference_images 를 담은 JSON 을 전송합니다. gpt-image-2 API 는 즉시 task_id 와 processing 상태를 반환합니다.
제출 후 10초를 대기한 뒤 5초마다 폴링하여 gpt-image-2 API 가 상태를 completed 또는 failed 로 바꿀 때까지 기다립니다. 일반적인 엔드투엔드 지연은 45–60초입니다.
완료된 gpt-image-2 API 응답에는 안정적인 https://file.gptimg.co URL 이 포함됩니다. 핫링크하거나 자체 스토리지로 미러링하거나 프런트엔드로 바로 전달하면 됩니다.
연동, 가격, rate limit
gpt-image-2 API 는 가입 시 무료 크레딧, 두 번의 클릭으로 발급되는 Bearer token, prompt 에서 호스팅 PNG 까지 45초 라운드트립을 제공합니다. SDK 설치도, 시작 시 신용카드도 필요 없습니다.