메인 콘텐츠로 건너뛰기
POST
모델은 gpt-image-2.6-ext, version은 flare / sunburst이며 이미지당 과금합니다. resolution은 **1k / 2k / 4k**를 지원하며 현재 **n: 1**을 사용합니다. 모든 품질 단계와 PNG / JPEG / WebP / SVG / GIF를 지원합니다.
이 페이지는 Ext API입니다. 토큰 과금 GPT-Image-2.6와 모델 이름 및 매개변수 규칙이 다릅니다.

인증

string
필수
플랫폼 API 키로 Bearer Token 인증을 사용합니다. API 키 관리에서 발급받고 Content-Type: application/json으로 제출하세요.

버전 선택

요청 매개변수

열거 값은 대소문자를 구분하지 않고 앞뒤 공백을 제거합니다. 예제는 소문자를 사용합니다.
string
필수
고정값 gpt-image-2.6-ext.
string
필수
필수이며 비어 있으면 안 되는 생성·편집 지침. 여러 참조는 첫 번째·두 번째 이미지로 지칭하고 변경 및 유지할 내용을 설명하세요.
string
기본값:"flare"
flare / sunburst, 기본값 flare. 다른 값은 HTTP 400. 버전별 가격은 다를 수 있습니다.
string
기본값:"1k"
1k / 2k / 4k(대문자 1K / 2K / 4K도 허용). size 비율과 함께 출력 픽셀을 결정합니다(아래 “비율과 크기” 표 참고). 이미지당 가격은 해상도별로 다르며, hd / 8k 등은 HTTP 400을 반환합니다.
string
기본값:"auto"
auto 또는 아래 10개 비율만 허용하며 1024x1024 같은 픽셀 값은 불가합니다. auto는 텍스트 생성 시 1:1, 편집 시 크기를 읽을 수 있는 첫 참조와 가장 가까운 지원 비율을 선택합니다. GIF는 생략하거나 auto를 사용하세요.
string
size의 별칭으로 하나만 사용하면 됩니다. 둘 다 전달하면 같아야 하며 다르면 HTTP 400. GIF에서는 생략 또는 auto만 가능합니다.
integer
기본값:"1"
현재 정수 1을 사용하세요.
string
auto / low / medium / high / xhigh / max. 생략하면 업스트림에 전달하지 않고 자동 선택합니다. auto는 low로 고정되지 않습니다. 품질은 이미지당 가격에 영향을 주지 않으며 높은 단계는 보통 오래 걸립니다. 다른 값은 HTTP 400.
string
기본값:"png"
png / jpeg / webp / svg / gif. jpg는 jpeg의 별칭. SVG·GIF는 텍스트 생성만 지원하며 다른 형식은 HTTP 400.
SVG 출력은 아직 지원하지 않습니다.
string
low / medium / high. 생략하면 업스트림이 결정합니다. 장면 복잡도를 제어하며 low는 간결한 아이콘·평면 일러스트, high는 풍부한 세부 묘사에 적합합니다. 단가에 영향이 없습니다.
string[]
최대 16장, 각각 최대 20 MB. PNG / JPEG / WebP / GIF / BMP 지원. 공개 HTTP(S) URL 또는 data:image/png;base64,... 같은 이미지 Data URL을 받습니다. 전달하면 편집 모드이며 SVG·GIF에는 참조를 사용할 수 없습니다.
resolution이 2k / 4k이면 참조 이미지로 GIF / BMP를 사용할 수 없습니다.
별칭 image_url, image, images, input_image, input_images도 지원하나 image_urls를 권장합니다. URL은 로그인 없이 공개 접근 가능해야 합니다.

비율과 크기

auto의 텍스트 생성은 1:1이며 1k 1024×1024, 2k 2048×2048, 4k 2880×2880입니다. 편집은 위 표에서 가장 가까운 비율을 선택하며 원본 픽셀 크기를 보장하지 않습니다.

참조 이미지 편집 예제

편집도 POST /v1/images/generations를 사용합니다. 예제 URL을 접근 가능한 실제 이미지로 교체하세요.

SVG 출력

output_format: "svg"로 설정하세요. 텍스트 생성만 가능하며 n=1이어야 합니다. size에 비율을 사용할 수 있고 complexity: "low"는 간결한 벡터 이미지에 적합합니다.
object
선택적인 SVG 작성 모델 설정으로 SVG 출력 전용입니다. 객체 전체를 생략할 수 있으며 SVG를 작성하는 텍스트 모델의 추가 요금은 없습니다.

GIF 애니메이션

output_format: "gif"로 설정하세요. 텍스트 생성만 가능합니다. size / aspect_ratio는 생략 또는 auto를 사용하세요. 비율 이름과 픽셀 값은 HTTP 400입니다. 프롬프트에 움직임과 반복 방식을 설명하세요.

미지원·무효 매개변수

제출과 작업 결과

제출 성공은 HTTP 200입니다. data[0].task_id를 읽고 작업 조회 API를 3–5초 간격으로 completed / failed까지 호출하세요. 클라이언트 타임아웃 후에도 생성 요청을 다시 제출하지 말고 기존 작업을 조회하세요.
아래는 작업 객체입니다. 응답이 {code, data} 형식이면 먼저 data를 읽으세요. Python / JavaScript 예제는 두 형식을 처리합니다.
result.images[0].url은 배열이며 첫 링크는 result.images[0].url[0]입니다. expires_at 전에 저장하세요. 권장 유효 기간은 완료 후 24시간입니다. cost / credits_cost는 최종 요금입니다. 일괄 조회는 POST /v1/tasks/batch, 본문은 {"task_ids":["task_xxx","task_yyy"]}입니다.

과금

이미지당 가격은 version × resolution만으로 결정됩니다. 품질, 형식(SVG / GIF 포함), 복잡도, 비율, 참조 수, svg.model은 가격에 영향이 없습니다. 현재 n=1을 사용하며 실패는 전액 환불됩니다. 최신 요금은 APIMart 가격 페이지 또는 /api/pricing에서 확인하세요.

오류 처리