메인 콘텐츠로 건너뛰기
POST
GPT-Image-2.5 · 텍스트-이미지

소개

GPT-Image-2.5는 빠른 일상 이미지 생성을 위한 Flare와 세부 표현을 위한 Sunburst로 구성됩니다. POST /v1/images/generations로 텍스트에서 포스터, 상품 이미지, 일러스트, 아이콘 및 인포그래픽을 생성합니다. 두 모델은 auto, low, medium, high, xhigh, max 품질과 PNG, JPEG, WebP 출력을 지원합니다. quality, size, background로 출력 품질과 크기 및 배경을 조정하세요. 투명 배경은 PNG 또는 WebP를 사용합니다.

모델 선택

두 모델은 이 페이지의 엔드포인트, 매개변수 및 응답 구조를 공유합니다. 예시는 Flare를 사용하며 model만 바꾸면 Sunburst로 전환할 수 있습니다. 나머지 필드는 작업에 맞게 설정하세요.

인증

string
필수
Bearer $GRAVITEX_API_KEY
string
필수
application/json

요청 매개변수

요청 예시

예시는 터미널 환경 변수 GRAVITEX_API_KEY에서 플랫폼 토큰을 읽습니다. 업로드 시 curl -F가 Content-Type과 boundary를 자동 생성하므로 multipart/form-data 헤더를 직접 고정하지 마세요.

기본 생성

투명 배경

user는 호환성용이며 더 이상 권장되지 않습니다. safety_identifier가 비어 있지 않으면 우선 사용하고 없거나 비어 있으면 user로 대체합니다.

스트리밍

제한 및 참고 사항

size 기본값은 auto입니다. WxH의 각 변은 16의 배수이며 비율은 1:3–3:1 범위입니다. image-2 가이드는 최대 변 3840px, 총 픽셀 655,360–8,294,400을 명시하고 2.5 API 참조도 모델별 제한을 요구합니다. 특히 GIF를 포함한 2.6 예산은 기존 모델 상한을 그대로 적용하지 말고 확인하세요. 이 페이지는 공식 문서에서 명시한 GPT-Image-2.5 사용법을 다룹니다. 2.6의 complexity, GIF, SVG 설명을 2.5에 그대로 적용하지 않습니다. 공통 API schema에 필드가 있다고 모든 모델과 채널이 지원하는 것은 아닙니다.

응답 예시

다음은 비스트리밍 응답 구조 예시입니다. 이미지 데이터와 토큰 수는 실제 생성 결과가 아닙니다. b64_json을 디코딩하여 해당 형식으로 저장하고 Base64 텍스트를 이미지 파일로 직접 저장하지 마세요.
stream=true는 SSE 이벤트로 미리보기와 최종 이미지를 읽습니다. 전체 응답을 단일 JSON 객체로 파싱하지 마세요.

응답 및 과금

비스트리밍 예시는 b64_json으로 이미지를 반환합니다. response_format=url로 이미지 링크를 기대하지 마세요. 같은 토큰 단가가 이미지당 같은 비용을 뜻하지 않으므로 실제 usage를 확인하세요. data[].b64_json과 usage를 반환합니다. 이미지는 Base64 디코딩 후 저장하세요. 아래는 OpenAI 표준 요금이며 GravitexAI 견적이 아닙니다. 캐시 요금은 공식 참고 가격입니다. 가이드에 따르면 GPT Image 2 / 2.5 캐시 입력 할인은 Responses 이미지 도구에만 적용되며 직접 Images API 호출(edits 포함)에는 적용되지 않습니다. 플랫폼 결제는 콘솔 기준입니다.

공식 참고 문서