이미지 편집

이미지 편집. 공식 OpenAI SDK 의 multipart/form-data 업로드와 JSON 본문(base64 문자열) 양쪽 모두 받습니다.

본문

modelstring필수

편집을 지원하는 모델 ID

promptstring필수

1~4000자

imagestring | file필수

원본 이미지 — JSON 이면 base64 문자열, multipart 면 파일 파트

maskstring | file선택

편집 영역 마스크. capabilities.image_mask 지원 여부 확인

ninteger선택

생성할 이미지 수 1~4 (기본 1)

sizestring선택

256x256 · 512x512 · 1024x1024 · 1792x1024 · 1024x1792 · 1536x1024 · 1024x1536 · auto. 선택 모델의 지원값만 허용하며 생략 시 모델 기본값

response_formatstring선택

url(기본) · b64_json

userstring선택

최종 사용자 식별자

multipart 전체 본문은 4 MiB, JSON 본문은 5 MiB까지 받습니다. 파일은 base64로 변환된 뒤에도 5 MiB 이하여야 합니다. 초과하면 413 request_too_large 또는 invalid_request_error를 반환합니다. 픽셀 크기뿐 아니라 인코딩된 바이트 크기도 확인하세요.

모델별 편집 지원

GET /v1/models에서 capabilities.image_editing: true인 모델을 선택하세요. capabilities.image_mask는 마스크 지원 여부입니다. 필드 생략은 지원 미확인이고, 미지원 옵션은 400입니다.

• Gemini 네이티브 이미지는 마스크 없는 프롬프트 편집만 지원합니다. mask를 보내면 400이며 무시되지 않습니다. n은 1만 지원하고, 크기 값의 비율·해상도 의미는 이미지 생성과 같습니다.
• Imagen 편집은 명시적인 size를 지원하지 않습니다(400). 일반 편집은 원본 크기를 유지하고 upscale은 2배로 처리합니다.
• size를 생략하면 모델별 기본 동작을 사용합니다. 공통 1024x1024 기본값을 강제로 넣지 않습니다. limits.supported_sizes·limits.max_images를 확인하되, 생성과 편집의 차이는 이 문서의 제한이 우선합니다.