GPT Image 2.6 API 연동 튜토리얼: Flare와 Sunburst 선택, GIF와 SVG 출력 실습

먼저 세 가지를 결정하세요: 라인, 모드, 출력 형식

첫 요청을 작성하기 전에 세 가지를 정해두면 이후에 코드를 반복해서 고칠 필요가 없습니다.

첫째, 라인은 Flare인지 Sunburst인지. 특별한 요구가 없다면 기본은 Flare입니다. 이미지 생성이 더 빨라 빠른 반복과 대량 생성에 적합합니다. medium 이상 품질에서 여러 차례 편집을 해야 하고 캐릭터/제품/레이아웃의 일관성이 매우 중요할 때만 Sunburst로 전환하세요. 두 라인의 파라미터, 사용법, 가격은 완전히 동일하므로 전환 비용은 모델 ID 하나를 바꾸는 것뿐입니다.

둘째, 모드는 텍스트→이미지인지 이미지→이미지인지. 프롬프트 하나에서 시작하면 텍스트→이미지이고, 이미 1–16장의 소스 이미지가 있고 이를 기반으로 수정하면 이미지→이미지입니다. 출력 형식의 선택 범위가 다르다는 점에 주의하세요. gif와 svg는 텍스트→이미지에서만 사용할 수 있고, 이미지→이미지는 png, jpeg, webp만 출력할 수 있습니다.

셋째, 출력 형식은 정적인지 애니메이션/벡터인지. 기본은 png입니다. 투명 배경이 필요하면 png 또는 webp를, 애니메이션이 필요하면 gif를, 확장 가능한 벡터가 필요하면 svg를 사용하세요.

세 가지 결정을 코드로 옮기면 모델 ID와 output_format 두 필드의 값이 됩니다. 이것들을 먼저 상수로 작성해두면 조정하면서 고치는 것보다 훨씬 편합니다.

네 가지 모델 ID와 Flare, Sunburst 선택 판단

모델 ID는 '라인 + 모드' 두 부분으로 구성되며 총 네 가지입니다:

• gpt-image-2.6-flare/text-to-image

• gpt-image-2.6-flare/image-to-image

• gpt-image-2.6-sunburst/text-to-image

• gpt-image-2.6-sunburst/image-to-image

명명 규칙은 직관적입니다. 앞부분은 라인, 뒷부분은 모드입니다. 요청 본문의 파라미터 이름, 값 범위, 과금 기준은 두 라인에서 완전히 동일하므로 하나의 함수로 감싸고 라인을 파라미터로 넘길 수 있습니다.

Sunburst를 반드시 써야 하는 경우

Sunburst는 디테일이 더 강조되어 medium 이상 품질에서 여러 차례 편집할 때 디테일이 더 일관됩니다. 대표적인 시나리오는 캐릭터 고정, 제품 외관 고정, 레이아웃 고정 상태에서 반복적으로 미세 조정하는 경우입니다. 워크플로가 '먼저 생성하고, 세 번 수정한다'라면 Sunburst의 이점은 이후 몇 차례에서 나타납니다.

Flare에 머물러야 하는 경우

단일 이미지 생성, 대량 생성, 프롬프트 효과를 빠르게 확인하는 경우에는 Flare가 더 빠르므로 더 나은 선택입니다. 두 라인의 가격이 완전히 같기 때문에 Flare를 선택해도 비용상의 불이익은 전혀 없습니다.

실무 조언: 개발 단계에서는 Flare로 파라미터와 형식을 통일해 테스트하고, 프로덕션에 들어간 후 여러 차례 편집이 필요한 사용 사례에 맞춰 라인을 전환하세요. 모델 페이지에서 먼저 Flare 텍스트→이미지와 Sunburst 텍스트→이미지의 필드 설명을 확인할 수 있습니다.

텍스트→이미지 핵심 파라미터 작성법

텍스트→이미지의 핵심 파라미터는 일곱 가지이며, 값과 제약을 하나씩 설명합니다.

quality와 resolution

quality는 low / medium / high / xhigh / max를 사용하며 디테일 등급을 결정하고, GIF의 유일한 과금 기준이기도 합니다. resolution은 1K / 2K / 4K이며 기본값은 1K입니다. 이 두 파라미터가 함께 단일 이미지 가격을 결정하며, 비용을 조절하는 두 개의 다이얼입니다.

complexity

low / medium / high를 사용하며 기본값은 high이고, 이는 계획 단계의 수준을 의미합니다. quality와 서로 독립적입니다. 하나는 구도 계획의 깊이를, 다른 하나는 이미지 디테일 등급을 담당합니다. quality를 낮췄다고 해서 complexity도 함께 바꾸지 마세요. 둘은 연동 관계가 아닙니다.

aspect_ratio

auto 또는 15가지 비율 중 하나를 사용합니다. 여기서 쉽게 놓치는 규칙이 하나 있습니다: GIF를 생성할 때는 aspect_ratio를 전달하지 않거나 auto를 전달합니다. GIF의 비율은 frame_size가 결정하므로 둘이 충돌하면 의미가 없습니다.

output_format과 output_compression

output_format은 png(기본) / jpeg / webp / gif / svg를 사용합니다. output_compression은 0–100이며 jpeg, webp에만 적용됩니다. png에 압축 파라미터를 전달해도 예상대로 동작하지 않습니다.

background

auto / opaque / transparent를 사용합니다. transparent는 반드시 png 또는 webp와 함께 써야 합니다. 투명 배경을 원하면서 jpeg를 선택했다면 형식을 바꿔야 합니다.

이 제약들은 한 가지만 기억하면 충분합니다: 형식이 다른 파라미터를 역으로 제한합니다 — gif는 비율의 출처를 고정하고, jpeg/webp만 압축을 적용하며, transparent는 png/webp만 허용합니다.

GIF 출력: frame_size, 프레임 수와 크기 상한

GIF는 텍스트→이미지에서만 생성할 수 있으며, 파라미터는 프레임에 집중되어 있습니다.

frame_size

각 프레임의 픽셀 너비와 높이로, 512x512처럼 '너비x높이' 형식으로 작성하며 양쪽 모두 16의 배수여야 하고 기본값은 512x512입니다. 이 값이 GIF의 전체 비율도 결정하므로 이때는 aspect_ratio를 전달하지 마세요. 1:1 같은 비율 표기는 허용되지 않으며 반드시 픽셀 값이어야 합니다.

frame_count와 frame_duration_ms

frame_count는 2–16이며 기본값은 9입니다. 크기와 관련된 제한이 하나 있습니다: 768x768은 최대 12 프레임입니다. frame_duration_ms는 20 이상이며 기본값은 200이고, 10ms 단위로 반올림됩니다.

세 가지 하드 상한

GIF 전체는 다음 조건도 충족해야 합니다: 각 변 3840 이하, 총 픽셀 8,294,400 이하, 종횡비 3:1 이하. 초과하면 제출 단계에서 바로 거부되며 과금되지 않으므로 이런 오류는 비용을 발생시키지 않지만 디버깅 시간을 낭비하게 합니다.

최소한의 사용 가능한 GIF 요청 본문:

{
  "model": "gpt-image-2.6-flare/text-to-image",
  "prompt": "a bouncing paper plane on white",
  "output_format": "gif",
  "frame_size": "512x512",
  "frame_count": 9,
  "frame_duration_ms": 200,
  "quality": "medium"
}

13–16 프레임을 생성하려면 frame_size를 512x512 또는 그보다 작게 하세요. 768x768은 최대 12 프레임입니다.

SVG 출력 사용법과 가격 계산

SVG 역시 텍스트→이미지에서만 사용할 수 있으며 이미지→이미지는 해당 형식을 허용하지 않습니다. 사용법은 output_format을 svg로 설정하기만 하면 되고, 나머지 파라미터는 일반적인 텍스트→이미지와 동일하게 작성합니다. background를 투명하게 하려면 여전히 형식 조합 규칙에 유의하세요.

과금 기준

SVG는 동일 등급 PNG 가격에 $0.030을 더한 금액으로 계산됩니다. 예를 들어 low 1K PNG가 $0.023이라면 동일 등급 SVG는 $0.053이고, high 2K PNG가 $0.090이라면 SVG는 $0.120입니다. 등급이 높을수록 SVG가 더 비싸지지만 추가되는 $0.030은 변하지 않습니다.

사용 조언

SVG는 로고, 아이콘, 도식처럼 무손실 확장이 필요한 대상에 적합합니다. 다운스트림 파이프라인이 최종적으로 비트맵을 필요로 한다면 png를 직접 쓰는 것이 더 간편합니다. 벡터 추가 요금을 더 내도 이점을 얻지 못합니다.

이미지→이미지: 소스 이미지, 마스크와 마크업 이미지 중 하나만

이미지→이미지 입력은 1–16장의 소스 이미지이며 형식은 jpeg / png / webp로 제한되고, 출력은 png / jpeg / webp만 가능합니다.

mask_url과 markup_url은 반드시 하나만 선택

• mask_url: 첫 번째 소스 이미지와 같은 크기의 RGBA PNG이며, 투명 픽셀이 수정할 영역을 나타냅니다.

• markup_url: 투명 PNG 마크업 이미지로, 이미지 위에 수정할 위치를 표시합니다. 마크업 자체는 생성 결과에 나타나지 않습니다.

둘은 상호 배타적이며 동시에 전달하면 거부됩니다. 선택 논리는 간단합니다. 시스템이 특정 픽셀만 정확히 건드리게 하려면 마스크를, '대략 이 위치'를 지정하고 단단한 경계로 제한되지 않기를 원하면 마크업 이미지를 사용하세요.

마스크 외부도 변할 수 있음

mask_url을 사용할 때는 마음의 준비가 필요합니다. 마스크 외부 영역도 약간 변할 수 있습니다. 비즈니스 요구 사항이 미선택 영역의 픽셀 단위 불변을 요구한다면 이미지→이미지 방식으로는 보장할 수 없으므로 합성 단계에서 직접 처리해야 합니다.

요금

이미지→이미지는 텍스트→이미지의 가격표를 따르며, 참고 이미지마다 $0.012가 추가됩니다. low 1K에서 1장을 전달하면 $0.035이고, 16장을 전달하면 $0.215입니다. 실제로 필요한 참고 이미지만 전달하세요.

요청 본문 예시:

{
  "model": "gpt-image-2.6-flare/image-to-image",
  "prompt": "change the background to warm sunset",
  "image_urls": ["https://your-cdn/source.png"],
  "mask_url": "https://your-cdn/mask.png",
  "output_format": "png"
}

필드 세부 사항은 Flare 이미지→이미지 페이지에서 확인할 수 있습니다.

비용 추정: 품질 등급과 크기별 단일 이미지 가격 계산

먼저 세 가지 과금 기준을 기억하세요:

• 텍스트→이미지(png/jpeg/webp): quality와 resolution이 함께 단일 이미지 가격을 결정합니다.

• SVG: 동일 등급 PNG 가격에 $0.030을 추가.

• GIF: quality만으로 과금되며 해상도와 무관합니다: low $0.070, medium $0.124, high $0.150, xhigh $0.266, max $0.598.

• 이미지→이미지: 동일 가격표에 참고 이미지마다 $0.012 추가.

한 장을 추정하는 방법

네 단계: 모드 결정(텍스트→이미지 또는 이미지→이미지) → 형식 결정(gif는 품질만, svg는 $0.030 추가, 나머지는 품질×해상도) → 해당 등급 단가 조회 → 이미지→이미지라면 $0.012 × 참고 이미지 장수 추가. 텍스트→이미지의 자주 쓰는 등급: low 1K $0.023, medium 1K $0.041, high 1K $0.049, high 2K $0.090, high 4K $0.160.

과금되지 않는 경우

제출 단계에서 거부된 요청은 전액 반환되며 차감되지 않습니다. 여기에는 파라미터가 유효하지 않은 경우(예: background=transparent에 jpeg를 설정, gif에 aspect_ratio를 전달)와 GIF 크기 초과가 포함됩니다. 즉 파라미터 검증 오류는 비용을 소모하지 않지만 반복을 늦추므로 클라이언트에서 먼저 한 차례 검증하는 것이 좋습니다.

전체 15개 등급은 가격 페이지에서 확인하세요. 이전 세대의 과금 방식을 비교하려면 GPT Image 2.5 Flare 텍스트→이미지를 참고하세요.

한 문장으로 요약하면: 기본은 Flare + 텍스트→이미지 + png, 여러 차례 편집이 있으면 Sunburst로 전환, 애니메이션 또는 벡터가 필요할 때 output_format을 변경하세요.