> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> OpenAI 계정 없이 LaoZhang API 키로 GPT Image 2.6을 호출합니다. 공식 포워딩은 GIF와 SVG를 출력하고, VIP와 웹 경로는 호출당 $0.03입니다.

GPT Image 2.6은 GPT Image 2.5의 뒤를 잇는 OpenAI 이미지 모델로, 빠른 **Flare**와 디테일이 풍부하고 편집이 안정적인 **Sunburst** 두 종류를 그대로 두고 애니메이션 GIF, SVG 벡터 출력, `complexity` 파라미터를 더했습니다. LaoZhang API에서는 세 가지 경로로 제공하므로 아래에서 하나를 고르세요.

## 경로 선택

| 경로 | 모델 ID | 가격 | 출력 | 일반적인 소요 시간 |
| - | - | - | - | - |
| 공식 API 포워딩 | `gpt-image-2.6-flare`, `gpt-image-2.6-sunburst` | 토큰 기준 | 정지 이미지, GIF, SVG, 네이티브 4K | Flare, 1024 이미지 8\~12초 |
| VIP 건당 과금 | `gpt-image-2.6-flare-vip`, `gpt-image-2.6-sunburst-vip` | 이미지당 \$0.03 | PNG, 네이티브 4K | 25\~55초 |
| 웹 경로 | `gpt-image-2.6-web` | 호출당 \$0.03 | PNG, JPEG, WebP, GIF, 네이티브 최대 약 2K | 15\~35초 |

* 토큰 그룹은 토큰을 만들 때 정하며, 요청 본문에는 넣지 않습니다.
  * 공식 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](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)가 더 저렴합니다.
* 2.6 VIP 모델은 `xhigh`와 `max`를 받지 않습니다. 이 두 단계를 고정 가격으로 쓰려면 2.5 VIP를 계속 쓰세요.

## 호출 전 준비

**1. 토큰 만들기**

[토큰 관리](https://api.laozhang.ai/token)에서 토큰을 만들고, 위 표에서 고른 경로에 맞는 그룹을 지정합니다. OpenAI 계정은 필요 없습니다.

**2. 환경 변수 설정**

```bash theme={null}
export LAOZHANG_API_KEY="LaoZhang API 키"
export BASE_URL="https://api.laozhang.ai/v1"
```

**3. 저장 스크립트 추가**

응답의 `data[]`에는 Base64(`b64_json`) 또는 다운로드 링크(`url`)가 담깁니다. 아래 스크립트를 `save_images.py`로 저장하세요. 파일 헤더로 PNG, JPEG, WebP, GIF, SVG를 구분해 알맞은 확장자로 저장합니다.

```python save_images.py theme={null}
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)")
```

실행 방법: `python3 save_images.py response.json 출력_접두사`

## GPT Image 2.6 (공식 포워딩)

GPT Image 2.6은 OpenAI의 더 새로운 이미지 모델이며, 이번에도 빠른 Flare와 디테일이 더 풍부하고 편집이 더 안정적인 Sunburst 두 종류가 있습니다. 공식 API 포워딩 그룹에서는 토큰 사용량으로 과금하며, API 토큰, 엔드포인트, 요청 본문이 2.5 공식 API 포워딩과 같아 `model`만 바꾸면 됩니다. `default` 그룹 토큰으로 건당 과금 호출도 할 수 있으며 GPT Image 2.6 VIP (건당 과금) 절에서 설명합니다.

| 항목 | 내용 |
| - | - |
| 모델 ID | `gpt-image-2.6-flare`, `gpt-image-2.6-sunburst` |
| 토큰 그룹 | `OpenAI Official` 또는 `OpenAI Official Enterprise`, 과금 방식은 **사용량 우선**(콘솔 표시: 按量优先) 또는 **사용량 과금**(按量计费) |
| 엔드포인트 | `/v1/images/generations`, `/v1/images/edits` |
| 단가 | [GPT Image 2.5 가이드](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)의 공식 API 포워딩 과금 절과 같습니다. 100만 토큰당 텍스트 입력 \$5, 이미지 입력 \$8, 이미지 출력 \$30 |
| 새 파라미터 | `output_format: "gif"`는 반복 재생되는 애니메이션 GIF를 반환합니다. `output_format: "svg"`는 SVG 벡터 이미지를 반환합니다(SVG를 작성하는 텍스트 모델은 기본값이 `gpt-6.1-terra`이며 추가 비용이 없고, `svg.model`로 바꿀 수 있습니다). `complexity`(`low`, `medium`, `high`, 기본값 `high`)는 장면의 복잡도를 조절하며 추가 비용이 없습니다 |
| 건당 과금 경로 | `gpt-image-2.6-flare-vip`, `gpt-image-2.6-sunburst-vip`, 이미지당 \$0.03. GIF, SVG, `xhigh`, `max`는 지원하지 않습니다. GPT Image 2.6 VIP (건당 과금) 절을 참고하세요. 웹 경로 `gpt-image-2.6-web`도 호출당 \$0.03이며 1024×1024 이상의 GIF를 만들고 SVG는 지원하지 않습니다. GPT Image 2.6 웹 경로 (GIF 지원) 절을 참고하세요 |

아래는 `OpenAI Official` 그룹에서 1024×1024 이미지 한 장의 이미지 출력 토큰과 비용을 2026년 11월 5일에 측정한 값입니다. 시간은 OpenAI에 직접 보낸 요청을 한 번씩 잰 결과입니다.

| `quality` | 출력 토큰 | 이미지당 | Flare 소요 시간 | Sunburst 소요 시간 |
| - | -: | -: | -: | -: |
| `low` | 824 | \$0.025 | 8초 | 34초 |
| `medium` | 1,449 | \$0.043 | 11초 | 42초 |
| `high` | 1,756 | \$0.053 | 12초 | 59초 |
| `xhigh` | 3,122 | \$0.094 | 23초 | 86초 |
| `max` | 7,024 | \$0.211 | 39초 | 157초 |

* `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`입니다.

GIF 생성 예제:

```bash theme={null}
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
```

`python3 save_images.py gif.json animation`을 실행하면 `.gif` 파일로 저장됩니다. GIF 규칙은 다음과 같습니다.

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

![GPT Image 2.6 Flare로 만든 반복 재생 GIF: 비 내리는 창턱에서 기지개를 켜고 하품하는 주황색 고양이](https://mintcdn.com/laozhangai-edd05f2c/12rpJOJJXqwT-_gR/images/samples/gpt26-en-gif.gif?s=b94485a5edd8435f6f655b736b977e39)

gpt-image-2.6-flare가 반환한 GIF: 512×512, 9프레임, 약 11초

### SVG 벡터 이미지 생성

GPT Image 2.6 공식 포워딩은 SVG 벡터 이미지를 바로 출력할 수 있습니다. 아이콘, 로고, 간단한 일러스트에 적합하며, 확대해도 깨지지 않고 색과 모양을 바로 수정할 수 있습니다. 기본 설정이면 SVG 작성은 무료이고, 1024×1024 아이콘 한 장은 참조 이미지 비용만 냅니다(`low` 약 \$0.025, `medium` 약 \$0.044). `output_format`을 `svg`로 지정하면 됩니다.

```bash theme={null}
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
```

`python3 save_images.py svg.json icon`을 실행하면 `.svg` 파일로 저장됩니다. OpenAI는 한 번의 요청 안에서 두 단계로 처리합니다. 먼저 이미지 모델이 `quality`에 맞춰 참조 이미지를 한 장 만들고, 이어서 GPT 텍스트 모델이 이를 SVG 코드로 작성합니다.

* 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입니다.

작성 모델별 비교입니다(2026년 11월 5일 측정, 같은 1024 아이콘 프롬프트, 모델마다 3회 이상).

| `svg.model` | 성공률 | SVG 작성 비용 | 소요 시간 | 결과 |
| - | - | -: | -: | - |
| `gpt-6.1-terra`(기본값) | 7/7 | 무료 | 33\~43초 | 선이 깔끔하고 gpt-5.5에 가까움 |
| `gpt-5.5` | 3/3 | 약 \$0.09\~0.16 | 42\~70초 | 디테일이 가장 좋음 |
| `gpt-6-sol`, `gpt-6.1-sol` | 각 2/3 | 약 \$0.02\~0.04 | 33\~49초 | 좋음 |
| `gpt-5.4-mini` | 3/3 | 무료 | 16초 | 형태가 거침 |
| `gpt-5.6-terra` | 0/3 | — | — | 권장하지 않음 |

실패는 모두 OpenAI가 반환한 502이며 게이트웨이와는 관계없습니다. 특별한 이유가 없다면 `svg.model`을 넣지 말고 기본 모델을 그대로 쓰세요.

* 지원하는 작성 모델은 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으로 만든 SVG 벡터 아이콘: 갈색 받침 위에서 김이 피어오르는 크림색 커피잔, 잔에는 초록 잎 무늬](https://mintcdn.com/laozhangai-edd05f2c/opsNeKybSpGGbpi9/images/samples/gpt26-svg-coffee.svg?fit=max\&auto=format\&n=opsNeKybSpGGbpi9\&q=85\&s=21bb7f4e2c881bb9d48f640a48804353)

gpt-image-2.6-flare 기본 설정으로 만든 SVG 아이콘: 4 KB, 약 42초, 비용 약 \\\$0.044(medium 참조 이미지만 과금, gpt-6.1-terra의 SVG 작성은 무료)

## GPT Image 2.6 VIP (건당 과금)

토큰 사용량 대신 고정 가격으로 `high` 이하 품질의 PNG를 주로 만든다면 2.6 VIP 모델을 쓰세요. 이미지당 \$0.03이며, 2.5 VIP에 쓰던 API 토큰을 그대로 쓸 수 있습니다.

| 항목 | 내용 |
| - | - |
| 모델 ID | `gpt-image-2.6-flare-vip`, `gpt-image-2.6-sunburst-vip`. 두 모델은 가격이 같고 소요 시간도 비슷합니다 |
| 토큰 그룹 | `default` 또는 다른 이미지 그룹, 과금 방식은 **사용량 우선**(콘솔 표시: 按量优先) 또는 **건당 과금**(按次计费) |
| 엔드포인트 | `/v1/images/generations`, `/v1/images/edits` |
| 가격 | 이미지당 \$0.03. 크기, 품질, 생성·편집 여부와 관계없이 같습니다 |
| `quality` | `low`, `medium`, `high`. `xhigh`와 `max`는 `400`을 반환하며 과금되지 않습니다 |
| `size` | 2.5 VIP와 같은 규칙으로 1K부터 4K까지 네이티브 생성합니다. 조건은 [GPT Image 2.5 가이드](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)의 크기와 품질 절을 참고하세요 |
| 출력 | PNG, 투명 배경 지원. `output_format`에 `jpeg`를 넣어도 PNG를 반환합니다 |
| 미지원 | GIF와 SVG. `output_format`이 `gif` 또는 `svg`이면 `400`을 반환하며 과금되지 않습니다. 필요하면 2.6 공식 포워딩을 쓰세요 |
| 소요 시간 | 2026년 11월 5일 측정: 1024×1024 약 25~~55초, 3840×2160 약 25~~45초, 편집 약 30\~40초 |

```bash theme={null}
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
```

편집과 투명 배경은 [GPT Image 2.5 가이드](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)의 VIP 건당 과금 모델 절 예제와 같은 방식으로 요청하고, `model`만 2.6의 `-vip` 모델 ID로 바꾸면 됩니다. 결과는 이 페이지의 `save_images.py`로 저장하세요.

다른 경로와 비교하면 다음과 같습니다.

* **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 지원)

`gpt-image-2.6-web`은 GPT Image 2.6의 웹 경로입니다. 호출당 \$0.03에 PNG, JPEG, WebP 이미지와 무한 반복 재생되는 애니메이션 GIF를 만들며, 2.5 웹 경로나 VIP 모델에 쓰던 API 토큰을 그대로 쓸 수 있습니다.

| 항목 | 내용 |
| - | - |
| 모델 ID | `gpt-image-2.6-web`. Flare와 Sunburst는 고를 수 없습니다 |
| 토큰 그룹 | `default` 또는 다른 이미지 그룹, 과금 방식은 **사용량 우선**(콘솔 표시: 按量优先, 권장) 또는 **건당 과금**(按次计费) |
| 엔드포인트 | `/v1/images/generations`(생성), `/v1/images/edits`(편집) |
| 가격 | 호출당 \$0.03. 크기, 프레임 수, 생성·편집 여부와 관계없이 같고, 200이 아닌 응답은 과금되지 않습니다 |
| `size` | 2.5 VIP와 같은 조건입니다. [GPT Image 2.5 가이드](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)의 크기와 품질 절을 참고하세요. GIF도 같은 조건이라 `512x512`, `256x256`은 거부되며, 가장 작은 정사각형은 `816x816`입니다 |
| 출력 형식 | PNG(기본값), `jpeg`, `webp`, `gif`(생성만) |
| 해상도 | 최대 약 2K까지 네이티브로 렌더링합니다. 4K `size`는 요청한 크기로 반환되지만 디테일은 약 2K를 확대한 수준이므로, 네이티브 4K가 필요하면 2.6 VIP를 쓰세요 |
| 미지원 | SVG, 그리고 편집(`/v1/images/edits`)에서 GIF 출력. 둘 다 `400`을 반환하며 과금되지 않습니다 |
| 소요 시간 | 2026년 11월 5일 측정: PNG 1024×1024 약 15~~35초, 편집 약 20~~30초 |

### GIF 애니메이션 생성

`/v1/images/generations`에 `"output_format": "gif"`를 지정하고, 필요하면 `frame_count`와 `frame_duration_ms`를 함께 보냅니다.

```bash theme={null}
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
```

이 페이지의 `save_images.py`로 저장하면 `.gif` 파일이 됩니다.

```bash theme={null}
python3 save_images.py gif.json animation
```

GIF 규칙은 다음과 같습니다.

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

### 오류 메시지 확인

크기나 프레임 값이 범위를 벗어나거나 편집에서 GIF를 요청하면 HTTP `400`이 반환되며 과금되지 않습니다. 이때 `message`에는 원인을 알려 주지 않는 일반 안내 문구(중국어)만 담기므로, 원인은 응답의 `param`과 `code`로 확인하세요.

| 원인 | `param` | `code` |
| - | - | - |
| `size`가 조건을 벗어남 | `size` | `invalid_value` |
| `n`이 1보다 큼 | `n` | `invalid_value` |
| `frame_count` 또는 `frame_duration_ms`가 범위를 벗어남 | — | `invalid_image_request` |
| 편집에서 `output_format: "gif"` 요청 | — | `invalid_image_request` |

### 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을 호출할 수 있나요?

네. OpenAI 계정이 아니라 LaoZhang API 키만 있으면 됩니다. 세 경로 모두 OpenAI 호환 Images 엔드포인트를 쓰므로, 기존 OpenAI SDK 코드에서는 `base_url`과 키를 바꾸고 2.6 모델 ID를 지정하면 됩니다.

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

VIP 모델(`gpt-image-2.6-flare-vip`, `gpt-image-2.6-sunburst-vip`)은 이미지당 \$0.03, 웹 경로 `gpt-image-2.6-web`은 호출당 \$0.03입니다. 크기와 품질은 가격에 영향을 주지 않습니다.

공식 API 포워딩은 토큰 기준으로 과금합니다. 1024×1024 이미지 한 장은 `low`에서 약 \$0.025, `high`에서 약 \$0.053이고, 네이티브 4K를 `high`로 만들면 약 \$0.10입니다. 단계별 금액은 위의 GPT Image 2.6 (공식 포워딩) 절에 있습니다. 200이 아닌 응답은 과금되지 않으며, [과금과 실패 처리](https://docs.laozhang.ai/ko/api-capabilities/image-billing-and-failures.md)를 참고하세요.

## 관련 문서

* [GPT Image 2.5 가이드](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md): 이전 모델. VIP 경로에서 `xhigh`와 `max`를 지원
* [GPT Image 2.6 출시 공지](https://docs.laozhang.ai/en/announcements/gpt-image-2-6-2026-11.md)(영어)
* [Images API 레퍼런스](https://docs.laozhang.ai/ko/api-reference/images.md): 공통 요청·응답 형식
* [이미지 API 비교](https://docs.laozhang.ai/ko/api-capabilities/image-generation-guide.md): GPT Image 2.6과 다른 이미지 모델 비교
* [호출 로그](https://docs.laozhang.ai/en/faq/call-logs.md): 요청별 모델, 그룹, 청구 금액 확인
* [모델 및 가격](https://docs.laozhang.ai/ko/models.md): 현재 가격과 그룹

## 출처

* [OpenAI image generation guide](https://developers.openai.com/api/docs/guides/image-generation)
* [OpenAI Images API reference](https://developers.openai.com/api/reference/resources/images)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.