GPT Image 2.6 API: GIF·SVG 출력, VIP 장당 $0.03

​

경로 선택

• 토큰 그룹은 토큰을 만들 때 정하며, 요청 본문에는 넣지 않습니다.
  • 공식 API 포워딩: OpenAI Official 또는 OpenAI Official Enterprise 그룹, 과금 방식은 사용량 우선(콘솔 표시: 按量优先) 또는 사용량 과금(按量计费)입니다.
  • VIP와 웹 경로: default 또는 다른 이미지 그룹, 과금 방식은 사용량 우선(按量优先) 또는 건당 과금(按次计费)입니다.
• 세 경로 모두 생성은 /v1/images/generations, 편집은 /v1/images/edits를 쓰며, 요청 형식은 OpenAI Images API와 같습니다.
• 선택 기준은 다음과 같습니다.
  • 공식 API 포워딩: SVG가 필요할 때, 편집 결과를 바로 GIF로 받을 때, 가장 빠른 응답이 필요할 때.
  • VIP: 네이티브 4K PNG를 고정 가격으로 받을 때.
  • 웹 경로: 1024×1024 이상의 GIF를 고정 가격으로 만들 때.

​

GPT Image 2.5와 달라진 점

• 새 출력 형식: 공식 API 포워딩은 애니메이션 GIF와 SVG 벡터 이미지를, 웹 경로는 GIF를 반환합니다.
• 새 파라미터 complexity(low, medium, high)로 화면의 복잡도를 조절하며, 추가 비용은 없습니다.
• 공식 API 포워딩에서 low와 medium은 2.5보다 토큰을 3~4배 쓰고, high 이상은 비용이 같습니다. 초안을 대량으로 만든다면 GPT Image 2.5가 더 저렴합니다.
• 2.6 VIP 모델은 xhigh와 max를 받지 않습니다. 이 두 단계를 고정 가격으로 쓰려면 2.5 VIP를 계속 쓰세요.

​

호출 전 준비

export LAOZHANG_API_KEY="LaoZhang API 키"
export BASE_URL="https://api.laozhang.ai/v1"

import base64
import json
import sys
import urllib.request
from pathlib import Path

if len(sys.argv) != 3:
    raise SystemExit("사용법: python3 save_images.py response.json 출력_접두사")


def decode_b64(value):
    # data:...;base64, 접두사가 있으면 제거하고, 빠진 = 패딩을 채웁니다
    if value.startswith("data:"):
        value = value.split(",", 1)[1]
    value = "".join(value.split())
    value += "=" * (-len(value) % 4)
    return base64.b64decode(value, validate=True)


def extension_of(raw):
    # 파일 헤더로 형식을 판별합니다: PNG, JPEG, WebP, GIF, SVG
    if raw.startswith(b"\x89PNG"):
        return "png"
    if raw.startswith(b"\xff\xd8"):
        return "jpg"
    if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP":
        return "webp"
    if raw.startswith(b"GIF8"):
        return "gif"
    if b"<svg" in raw[:2048]:
        return "svg"
    raise RuntimeError("알 수 없는 이미지 형식입니다")


payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
if payload.get("error"):
    raise RuntimeError(payload["error"])
items = payload.get("data") or []
if not items:
    raise RuntimeError("응답에 이미지가 없습니다. 오류 메시지와 호출 로그를 확인하세요")

for index, item in enumerate(items, start=1):
    if item.get("b64_json"):
        raw = decode_b64(item["b64_json"])
    elif item.get("url"):
        with urllib.request.urlopen(item["url"], timeout=60) as download:
            raw = download.read()
    else:
        raise RuntimeError(f"{index}번째 항목에 이미지 데이터도 URL도 없습니다")
    output = Path(f"{sys.argv[2]}-{index}.{extension_of(raw)}")
    output.write_bytes(raw)
    print(f"저장됨: {output} ({len(raw)} bytes)")

​

GPT Image 2.6 (공식 포워딩)

• high 이상에서는 2.6과 2.5의 비용이 같습니다. low와 medium에서는 2.6이 토큰을 3~4배 쓰므로, 초안을 대량으로 뽑을 때는 2.5가 더 저렴합니다.
• 가로형 1536×1024는 토큰을 더 적게 씁니다. low에서 664, high에서 1,353토큰입니다.
• 3840×2160 네이티브 4K를 high로 생성하면 약 3,337토큰(약 $0.10)입니다.
• quality는 항상 지정하세요. 빠뜨리면 Flare가 프롬프트를 보고 단계를 정하는데, 프롬프트가 자세하면 1024 이미지 한 장에 약 5,800토큰을 쓸 수 있습니다. Sunburst의 기본값은 high입니다.

curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "창밖에 가는 비가 내리는 창턱에서 주황색 고양이가 기지개를 켠 뒤 하품하는 장면, 플랫 일러스트 스타일, 반복 재생 애니메이션",
    "output_format": "gif",
    "size": "512x512",
    "frame_count": 9,
    "frame_duration_ms": 200,
    "quality": "medium"
  }' -o gif.json

• frame_count의 기본값은 9프레임입니다. frame_duration_ms의 기본값은 200이며 20 이상이어야 합니다.
• 모든 프레임을 한 장의 시트에 렌더링하므로, size가 작은데 프레임이 많으면 No supported sheet fits 오류가 납니다. 512x512에 4~9프레임이면 그대로 동작하며, medium으로 9프레임을 만들면 약 2,073토큰(약 $0.06)입니다.
• stream은 지원하지 않습니다.

​

SVG 벡터 이미지 생성

curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "김이 피어오르는 커피잔 플랫 아이콘, 잔에는 초록 잎 무늬, 따뜻한 갈색과 크림색 배색",
    "output_format": "svg",
    "quality": "medium",
    "size": "1024x1024"
  }' -o svg.json

• SVG를 작성할 텍스트 모델은 svg.model로 지정합니다. 생략하면 기본값 gpt-6.1-terra를 씁니다.
• 직접 지정할 수도 있습니다. 예: "svg": {"model": "gpt-5.5"}(gpt-5.5는 작성 비용이 따로 과금되며, 아래 과금 설명을 참고하세요). 텍스트 모델만 넣을 수 있으며, 이미지 모델을 넣으면 model_not_found 오류가 납니다.

• 참조 이미지: 일반 이미지 생성과 같이 usage 기준 공식 단가로 과금됩니다.
• SVG 작성: 기본값 gpt-6.1-terra와 다음 저가 텍스트 모델 8개는 무료입니다.
  • gpt-5.4-mini, gpt-5.4-nano, gpt-5-mini, gpt-5-nano
  • gpt-4.1-mini, gpt-4o-mini, gpt-5.6-luna, gpt-6-luna
• 그 밖의 작성 모델(예: gpt-5.5, gpt-6-sol)은 해당 모델의 공식 단가로 과금되며, 사용량은 응답의 svg_usage에 담깁니다. 사용 로그에서는 이 비용을 같은 금액의 텍스트 입력 토큰으로 환산해 더하고, 환산된 토큰 수는 svg_usage.billed_as_text_input_tokens에서 확인할 수 있습니다. 무료 모델이면 이 값은 0입니다.

• 지원하는 작성 모델은 GPT-5.x, GPT-6.x, GPT-4.1, GPT-4o, o3 등 GPT 텍스트 모델입니다. 목록에 없는 모델은 unsupported_svg_model을 반환하며 과금되지 않습니다.
• 선택 파라미터 svg.reasoning.effort(low, medium, high 등)로 SVG를 작성할 때의 추론량을 조절합니다. 측정해 보니 high는 기본값보다 토큰을 2.6~14배 썼으므로, 아이콘이라면 기본값으로 충분합니다.
• 장면이 복잡할수록 SVG 코드가 길어져 비용과 소요 시간이 늘고, OpenAI 쪽 실패도 잦아집니다.
• 디테일이 많은 전체 일러스트(카페 실내 전체 등)는 실측에서 대부분 실패했고, 한 번 실패하는 데 2~3분이 걸렸습니다. SVG는 아이콘, 로고, 간단한 그래픽에 사용하세요.
• 이미지 생성 엔드포인트(/v1/images/generations)만 지원합니다. 편집과 stream은 지원하지 않으며 n은 1이어야 합니다.
• OpenAI가 502를 반환하면 게이트웨이가 자동으로 재시도하거나 다른 경로로 전환합니다. 모두 실패하면 오류(보통 svg_generation_failed)를 반환하며 과금되지 않습니다.
• 실패하면 참조 이미지도 반환되지 않습니다. 잠시 후 다시 시도하거나 프롬프트를 단순하게 바꿔 보세요.

​

GPT Image 2.6 VIP (건당 과금)

export LAOZHANG_API_KEY="YOUR_DEFAULT_GROUP_KEY"

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare-vip",
    "prompt": "A product photo of a white ceramic mug on a gray desk in soft natural light",
    "size": "2048x2048",
    "quality": "high"
  }' \
  -o vip-generation.json

python3 save_images.py vip-generation.json vip-generation

• 2.6 공식 포워딩: high 품질 1024 이미지 한 장이 약 $0.053으로, VIP의 $0.03보다 비쌉니다. GIF나 SVG가 필요하거나 더 빠른 응답(Flare 8~12초)이 필요하면 공식 포워딩을 쓰세요.
• 2.5 VIP: 같은 $0.03에 xhigh와 max를 지원합니다. 이 두 단계가 필요하면 2.5 VIP를 계속 쓰세요.
• 2.6 웹 경로: 같은 $0.03에 더 빠르게(보통 20~35초) 응답하고, 프레임 수를 지정한 GIF도 만들 수 있습니다. 네이티브 출력은 약 2K까지이고 4K는 확대한 결과이므로, 1K·2K에는 웹 경로를, 네이티브 4K PNG가 필요하면 2.6 VIP를 쓰세요. 아래 GPT Image 2.6 웹 경로 (GIF 지원) 절에서 설명합니다.

​

GPT Image 2.6 웹 경로 (GIF 지원)

​

GIF 애니메이션 생성

export LAOZHANG_API_KEY="YOUR_DEFAULT_GROUP_KEY"

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-web",
    "prompt": "창밖에 가는 비가 내리는 창턱에서 주황색 고양이가 기지개를 켠 뒤 하품하는 장면, 플랫 일러스트 스타일, 반복 재생 애니메이션",
    "size": "1024x1024",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 120
  }' \
  -o gif.json

python3 save_images.py gif.json animation

• frame_count는 264이고 기본값은 9입니다. frame_duration_ms는 202000이고 기본값은 200입니다. 반환되는 GIF는 요청한 프레임 수와 프레임 간격을 그대로 따릅니다.
• size는 항상 지정하세요. 생략하면 439×390처럼 작고 불규칙한 크기의 GIF가 반환됩니다. 1024x1024를 권장합니다.
• n은 1이어야 합니다.
• stream: true를 보내도 되지만, 중간 이미지 없이 완성된 GIF를 마지막에 한 번에 반환합니다.
• 소요 시간과 파일 크기는 다음과 같습니다.
  • 1024×1024, 49프레임: 약 3542초, 1~2.5MB
  • 1024×1024, 16프레임: 약 100초, 약 5MB
  • 1024×1024, 64프레임: 약 2분, 약 18MB(프레임마다 조금 흐려짐)
  • 2048×2048, 9프레임: 약 54초, 약 11MB
• 클라이언트 타임아웃은 300초 이상으로 설정하세요.
• 요청이 몰리는 시간에는 크기가 크거나 프레임이 많은 GIF가 약 2분 뒤 429를 반환할 수 있습니다. 과금되지 않으니 잠시 후 다시 시도하거나 프레임 수나 크기를 줄이세요.

​

오류 메시지 확인

​

GIF 경로 선택

• gpt-image-2.6-web: 1024×1024 이상의 GIF를 호출당 $0.03 고정 가격으로, 프레임 수와 간격을 지정해 만들 때 쓰세요.
• 2.6 공식 포워딩: 512×512 GIF, 편집 결과를 GIF로 받아야 할 때, 또는 SVG가 필요할 때 쓰세요. 토큰 과금이며 512×512, 9프레임, medium이면 약 $0.06입니다.
• 2.6 VIP: GIF가 필요 없고, high 품질까지의 PNG를 네이티브 4K로 $0.03에 받을 때 쓰세요.

​

자주 묻는 질문

​

OpenAI 계정 없이 GPT Image 2.6을 호출할 수 있나요?

​

GPT Image 2.6 API는 이미지 한 장에 얼마인가요?

​

관련 문서

• GPT Image 2.5 가이드: 이전 모델. VIP 경로에서 xhigh와 max를 지원
• GPT Image 2.6 출시 공지(영어)
• Images API 레퍼런스: 공통 요청·응답 형식
• 이미지 API 비교: GPT Image 2.6과 다른 이미지 모델 비교
• 호출 로그: 요청별 모델, 그룹, 청구 금액 확인
• 모델 및 가격: 현재 가격과 그룹

​

출처

• OpenAI image generation guide
• OpenAI Images API reference