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 종속성, 숨겨진 재시도 로직이 없습니다.