메인 콘텐츠로 건너뛰기
POST
GPT-Image-2 · 이미지-이미지

소개

GPT-Image-2는 POST /v1/images/edits로 참조 이미지를 편집하고 부분 리터치, 스타일 전환 및 다중 참조를 처리합니다. 변경 및 유지할 내용을 명시하세요. 입력은 항상 높은 충실도로 처리하므로 input_fidelity는 생략하며 영역 편집은 mask를 사용합니다.

인증

string
필수
Bearer $GRAVITEX_API_KEY
string
필수
application/json / multipart/form-data

요청 매개변수

images / mask

JSON은 images: [{"image_url": "https://..."}] 또는 base64 data URI를 사용합니다. multipart는 image[]로 파일을 업로드합니다. 플랫폼 연동 설명에 따르면 JSON 편집은 multipart로 변환되며 OpenAI file_id 참조는 지원하지 않습니다. 편집 영역은 mask로 지정합니다. JSON은 image_url, multipart는 파일을 사용합니다.

요청 예시

예시는 터미널 환경 변수 GRAVITEX_API_KEY에서 플랫폼 토큰을 읽습니다. 업로드 시 curl -F가 Content-Type과 boundary를 자동 생성하므로 multipart/form-data 헤더를 직접 고정하지 마세요.
접근 가능한 HTTPS URL 또는 base64 data URI를 사용하세요. multipart 예시는 공식 이미지를 먼저 다운로드합니다. 플랫폼 연동 설명은 OpenAI file_id 참조를 지원하지 않습니다.

JSON

multipart/form-data

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

마스크 부분 편집

스트리밍

제한 및 참고 사항

size 기본값은 auto입니다. WxH의 각 변은 16의 배수이며 비율은 1:3–3:1 범위입니다. image-2 가이드는 최대 변 3840px, 총 픽셀 655,360–8,294,400을 명시합니다. 공식 Images API JSON 편집은 PNG, JPEG, WebP 참조 1–16장, 각 50MB 미만을 허용합니다. mask는 첫 참조와 크기가 같은 alpha 채널 PNG입니다. 투명 영역은 편집을 유도하지만 픽셀 단위 경계를 보장하지는 않습니다. 게이트웨이가 검증하지 않아도 상위 서비스 제한은 적용됩니다. quality는 auto / low / medium / high이며 기본 auto입니다. image-2 투명 배경은 미리보기 기능이며 사용 가능 시 PNG 또는 WebP와 background=transparent를 사용합니다. 2.6 complexity, GIF, SVG 또는 2.5 markup 지원을 그대로 적용하지 않습니다.

응답 예시

다음은 비스트리밍 응답 구조 예시입니다. 이미지 데이터와 토큰 수는 실제 생성 결과가 아닙니다. 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 포함)에는 적용되지 않습니다. 플랫폼 결제는 콘솔 기준입니다.

공식 참고 문서