메인 콘텐츠로 건너뛰기
프로덕션 이미지 생성에는 /v1/images/generations를 사용하세요.
응답은 task를 반환합니다.

동기 변형

/v1/images/generations/sync는 task를 생성하고 설정된 최대 대기 시간까지 기다립니다. 호환성 확보와 데모 용도로 사용하세요. 프로덕션 워크로드에는 비동기 엔드포인트를 사용하세요.

이미지 편집

/v1/images/edits는 선택한 모델이 참조 이미지를 지원하는 경우 OpenAI 스타일의 이미지 편집 워크플로를 지원합니다.

GPT Image 2.5 품질과 라우팅

gpt-image-2.5는 Flare로 고정된 별칭이며 정밀 편집에는 gpt-image-2.5-sunburst를 사용합니다. quality의 auto/low/medium/high/xhigh/max와 resolution의 1K/2K/4K는 독립적입니다. 명시적 픽셀 크기는 해상도 단계와 일치해야 하며, APIAny는 필드를 버리지 않고 호환 경로만 비용순으로 선택합니다.
편집은 최대 16개의 참조 이미지와 선택적 마스크를 지원합니다.

GPT Image 2.6

gpt-image-2.6은 기존 이미지 엔드포인트에서 PNG와 애니메이션 GIF를 요청하며 별도 GIF API는 필요하지 않습니다. 성공한 요청당 30크레딧이며 결과 하나를 반환합니다. 호출 전에 GET /v1/models에서 사용 가능 여부를 확인하세요. output_format: "png"(기본값) 또는 "gif", quality: "auto", resolution: "1K", n: 1을 사용하세요. size는 auto, 1:1, 3:2, 2:3, 1024x1024, 1536x1024, 1024x1536입니다. 참조 이미지는 최대 한 장이며 별칭과 model_params에도 같은 제한이 적용됩니다. 충돌 값은 HTTP 400을 반환합니다. SVG, JPEG, WebP, 2K/4K, 마스크, 압축, frame_count, frame_duration_ms는 지원하지 않습니다. GIF 크기, 프레임 수와 간격은 설정할 수 없습니다. background는 생략 가능하며 auto만 허용합니다. SVG 요청은 PNG 대신 HTTP 400을 반환합니다.

PNG 동기 대기

참조 이미지 한 장으로 GIF 생성

편집 엔드포인트는 JSON의 image_urls 한 항목 또는 multipart의 image 파일을 받습니다. 마스크는 추가하지 마세요. output_format으로 결과 형식을 선택하며 GIF 편집도 애니메이션 파일 하나를 반환합니다.
multipart/form-data로 참조 파일 한 장을 업로드할 수도 있습니다:
동기 및 편집 엔드포인트는 완료 시 HTTP 200과 data[0].url을, 대기 시 HTTP 202, task_id, poll_url을 반환합니다. /v1/tasks/{task_id}를 completed 또는 failed가 될 때까지 폴링하세요. pending 또는 processing이면 같은 작업 ID를 유지하세요. 비동기 생성은 /v1/images/generations를 사용하며 완료 파일은 result.data[0].url에 있습니다. 유효하지 않거나 정적인 GIF 결과는 실패하며 일반 실패 작업 크레딧 환불 정책을 따릅니다. 전체 매개변수, 비동기 PNG/GIF 예제 및 폴링 응답