이미지 생성 및 편집

OpenAI 호환 이미지 엔드포인트로 이미지를 생성 및 편집하고, 멀티파트 및 JSON 이미지 URL 입력을 지원합니다.

개요

표준 OpenAI 이미지 라우트를 사용하여 새 이미지를 생성하거나 기존 이미지를 편집하며, 멀티파트 파일 업로드 및 gpt-image-2용 비스트리밍 JSON 이미지 URL 입력을 지원합니다.

이미지 생성

POST/v1/images/generations
  • 표준 엔드포인트: POST /v1/images/generations(operationId: openai.images.generations)는 텍스트 프롬프트로부터 이미지를 생성합니다.
  • 생성 매개변수: prompt, 선택적 model, n, quality, size를 지원합니다.
  • 호환 별칭: POST /openai/v1/images/generations(operationId: openai.images.generations.alias)도 지원합니다.

이미지 편집

POST/openai/v1/images/edits
json
{
  "model": "gpt-image-2",
  "prompt": "이 참조 이미지들을 결합하여 일관된 초현실주의 초상화를 만듭니다.",
  "images": [
    { "image_url": "https://cdn.example.com/reference-1.png" },
    { "image_url": "https://cdn.example.com/reference-2.png" }
  ],
  "mask": {
    "image_url": "https://cdn.example.com/mask.png"
  },
  "n": 1,
  "quality": "medium",
  "size": "1024x1024"
}
  • 표준 엔드포인트: POST /openai/v1/images/edits(operationId: openai.images.edits) 및 호환 별칭 POST /v1/images/edits(operationId: openai.images.edits.alias).
  • JSON URL 입력: gpt-image-2 및 지원되는 네이티브 채널의 경우, model, prompt, 1~16개의 image_url 객체를 담은 images 배열, 선택적 mask 객체(image_url)를 포함한 비스트리밍 JSON을 전송합니다.
  • 공개 HTTPS 요구 사항: 이미지 URL은 인증 정보가 포함되지 않은 공개적으로 접근 가능한 HTTPS 주소여야 합니다.
  • 품질 및 크기 제어: gpt-image-2의 기본 quality는 medium이며(low 및 high도 지원), 추가 파라미터는 업스트림으로 투명하게 전달됩니다.
  • 작업 계약: operationId: openai.images.edits로 게시되며 호환 별칭 POST /v1/images/edits를 지원합니다.