openai15,600 cr/장

GPT Image 2 편집

OpenAI GPT Image 2 기반 이미지 편집(image-to-image). 레퍼런스 이미지와 프롬프트로 기존 이미지를 편집·변형합니다. 무손실 보장을 위해 레퍼런스 1장·1024²·quality low로 고정됩니다.

엔드포인트

POST/api/v1/images/edits

Base URL: https://billing-ai.doublezero.kr

인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰으로 API Key를 포함해야 합니다.

Authorization: Bearer YOUR_API_KEY

요청 파라미터

이름	타입	필수	설명	기본값
`model`*	string	* 필수	사용할 모델 ID. 이 페이지에서는 "gpt-image-2-edit"를 사용합니다.	-
`prompt`*	string	* 필수	편집 지시 프롬프트. 최대 1,000자까지 지원합니다.	-
`image`*	string	* 필수	편집할 레퍼런스 이미지. base64 또는 data URI(예: data:image/png;base64,...)로 전달합니다. 레퍼런스는 1장만 지원합니다.	-
`mask`	string	선택	편집 영역 마스크(선택). 투명 픽셀이 편집 대상입니다. base64 또는 data URI로 전달합니다.	-
`size`	string	선택	이미지 크기. 무손실 보장을 위해 서버가 1024x1024로 고정하며, 다른 값은 무시됩니다. `1024x1024`	`1024x1024`
`response_format`	string	선택	응답 형식. gpt-image-2 편집은 항상 Base64 인코딩된 이미지(b64_json)로 반환합니다. `b64_json`	`b64_json`

응답 필드

이름	타입	필수	설명	기본값
`created`*	number	* 필수	생성 타임스탬프 (Unix epoch)	-
`data`*	array	* 필수	편집된 이미지 배열. 각 항목에 b64_json(Base64 이미지)을 포함합니다.	-

코드 예제

curl -X POST https://billing-ai.doublezero.kr/api/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-edit",
    "prompt": "배경을 노을 지는 해변으로 바꿔줘",
    "image": "data:image/png;base64,iVBORw0KGgo..."
  }'

참고 사항

•레퍼런스 이미지는 1장만 지원합니다. 2장 이상을 보내면 400(too_many_images)으로 거부됩니다.
•무손실 보장을 위해 size는 1024x1024, quality는 low로 서버가 고정하며, 고객 지정값은 무시됩니다. 편집 프롬프트는 최대 1,000자입니다.
•레퍼런스 이미지는 요청 본문에 base64(또는 data URI) 문자열로 담아 보냅니다(멀티파트 업로드는 서버가 대신 처리합니다).