/v1/images/generations를 사용하세요.
동기 변형
/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는 필드를 버리지 않고 호환 경로만 비용순으로 선택합니다.
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 편집도 애니메이션 파일 하나를 반환합니다.
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 예제 및 폴링 응답