GPT-Image 매개변수 및 API 차이
이미지 생성 및 편집 API에서 GPT-Image 계열의 매개변수 차이와 사용 방법을 알아봅니다.
선택한 모델에 맞게 생성, 편집, 출력 매개변수를 조정하세요. 전체 요청 및 응답 구조는 이미지 생성과 이미지 편집을 참고하세요.
대상 모델
| 모델 | 지원 API |
|---|---|
| gpt-image-2.6-sunburst신규 gpt-image-2.6-flare신규 gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5 | OpenAI Images: 이미지 생성, 이미지 편집 |
생성 매개변수 차이
| 필드 | 차이 설명 |
|---|---|
quality | 2.6과 2.5는 auto/low/medium/high/xhigh/max를 지원하며, 2와 1.5는 auto/low/medium/high를 지원합니다. 모두 기본값은 auto입니다 |
size | 1.5는 auto, 1024x1024, 1024x1536, 1536x1024를 지원합니다. 2와 2.5는 사용자 지정 크기를 지원하며, 각 변은 16의 배수이면서 3840 이하여야 합니다. 종횡비는 1:3 |
size (2.6) | auto 또는 사용자 지정 크기를 지원합니다. 너비와 높이는 16의 배수, 종횡비는 1:3~3:1이어야 합니다. GIF에는 프레임 수와 총 픽셀 예산 제한도 있으므로 정적 이미지 크기 설정을 그대로 사용하지 마세요 |
complexity | 2.6은 low/medium/high를 지원하며 기본값은 high입니다. 생성 전 계획에 투입하는 연산을 제어하고, quality는 렌더링 세부 수준을 제어합니다. 두 값은 독립적으로 설정합니다 |
background | 투명 배경은 transparent를 명시하고 래스터 출력에 png 또는 webp를 사용하세요. JPEG는 알파 채널을 유지하지 않습니다. 2의 투명 배경은 공식 미리 보기 기능입니다 |
편집 매개변수 차이
| 필드 | 차이 설명 |
|---|---|
input_fidelity | 1.5는 low/high를 지원하며 기본값은 low입니다. 입력 세부 정보를 보존하려면 high를 선택하세요. 2는 항상 높은 충실도로 처리하므로 이 필드를 생략합니다. 2.6도 생략하며, 1.5 설정을 새 모델에 그대로 적용하지 마세요 |
markup | 2.5와 2.6은 마크업 기반 편집을 지원합니다. 방향 보정 후 첫 번째 입력 이미지와 크기가 같고 투명 영역이 있는 PNG 오버레이를 제공하고 프롬프트에 변경 내용을 설명하세요 |
mask, markup | 둘 중 하나를 선택합니다. 여러 이미지 입력 시 첫 번째 이미지에 적용됩니다. 마스크는 투명 영역으로 편집 위치를 지정하고, 마크업은 원이나 화살표 등의 표시로 수정 위치를 알려줍니다 |
output_format | 편집 결과는 png/jpeg/webp를 사용합니다. SVG 또는 GIF 출력은 이미지 생성 API를 사용하세요 |
출력 형식 차이
| 필드 | 차이 설명 |
|---|---|
output_format | 여섯 모델 모두 png/jpeg/webp를 지원하며 기본값은 png입니다. 2.6 이미지 생성은 svg/gif도 지원합니다 |
output_compression | jpeg/webp에만 사용하며 범위는 0～100입니다. PNG, SVG, GIF에서는 생략합니다 |
| SVG | 2.6 이미지 생성에서 output_format: "svg"와 n: 1을 설정하고 스트리밍이나 중간 이미지는 사용하지 마세요. data[0].b64_json을 디코딩하여 .svg로 저장합니다. 내용은 UTF-8 XML입니다 |
svg | 최상위 이미지 model과 별도로 SVG 작성 모델을 선택합니다. SVG 모델 선택이 활성화된 경우에만 svg.model을 입력하고, 그렇지 않으면 객체 전체를 생략하세요. svg.reasoning과 이미지의 complexity는 별도로 제어합니다 |
| GIF | 2.6 이미지 생성에서 output_format: "gif"를 설정합니다. 스트리밍, 중간 이미지, 사용자 지정 압축을 사용하지 마세요. data[].b64_json을 디코딩하여 .gif로 저장합니다 |
frame_count | GIF에만 사용하며 2～16프레임, 기본값은 9입니다. 프레임 수, 프레임 크기, n은 총 픽셀 예산을 공유하므로 초과하면 이 중 하나를 줄이세요 |
frame_duration_ms | GIF에만 사용하며 20～2000밀리초, 기본값은 200입니다. 10밀리초 단위로 반올림됩니다 |
요청 예제
MODEL_ID를 플랫폼에서 제공하는 전체 모델 ID로 바꾸세요. 아래 생성, SVG, GIF 예제는 2.6을 사용하며 마크업 편집은 2.5 또는 2.6을 사용합니다.
curl 'https://api.agtcloud.ai/v1/images/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "제목이 OPEN TODAY인 간결한 카페 개업 포스터, 읽기 쉬운 글자 배치",
"quality": "medium",
"complexity": "high",
"size": "1024x1024",
"output_format": "png"
}'