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

# GPT-Image-2.6-All 이미지 생성 및 편집

> ChatGPT 웹 역방향 라우트를 통한 GPT 이미지 생성: gpt-image-2.6-all, 이미지당 $0.025, 10~46초; 최대 1536 해상도의 ChatGPT 기본 품질(지문 포함), 기본 GIF / SVG, 대형 캔버스 호환성을 위한 2K/4K 초해상도, 투명 배경 및 여러 이미지 편집.

> [!NOTE]
>
> 모든 이미지 API는 **동기식**입니다. 작업 ID가 없으므로 클라이언트 연결이 끊기면 요청 요금은 계속 청구되지만 결과는 손실됩니다. 넉넉한 타임아웃을 설정하십시오(600초 권장). [이미지 API 모범 사례](https://docs.apiyi.com/ko/api-capabilities/image-api-best-practices.md)를 참조하십시오.

## 개요

**gpt-image-2.6-all**은 Images 2.6을 기반으로 하는 APIYI의 **ChatGPT 웹 역방향 라우트용 GPT 이미지 생성 모델**입니다. prompt 안에 크기 힌트만 입력할 수 있었던 이전 `-all` 라우트와 달리, 이 라우트는 **`size`, `n`, `background` 및 `output_format`를 실제로 적용**하며 GIF, SVG 및 여러 이미지 편집 결과를 반환할 수 있습니다. 크기, 형식, 이미지 수를 지정해야 하는 프로덕션 코드에 더 적합합니다.

이 라우트가 특히 뛰어난 세 가지 기능은 \*\*GIF, SVG, 그리고 1536 이하에서의 ChatGPT 네이티브 품질(지문 포함)\*\*입니다. 2K/4K는 **대형 캔버스 호환성을 위한 초해상도 등급**입니다. 크기는 커지지만 반드시 더 세밀해지는 것은 아닙니다. 품질을 원한다면 약 1.5K를 유지하세요.

표준 OpenAI Images API 엔드포인트를 사용합니다. 텍스트-이미지 생성에는 `POST /v1/images/generations`, 편집에는 `POST /v1/images/edits`를 사용합니다.

* **가격**: **이미지당 \$0.025**, 호출당 과금됩니다. 2K/4K도 가격은 동일합니다.
* **속도**: 약 **10–46초**(1K는 10–22초, 2K는 12–24초, 4K는 15–42초이며, 꼬리 지연 시간은 60초를 넘을 수 있습니다)
* **품질**: 긴 변이 **512–1536이면 네이티브**입니다. ChatGPT 웹 품질과 지문을 가장 잘 제어할 수 있으며, **2K/4K는 초해상도**로, 대형 캔버스 크기 문제를 해결하지만 1.5K보다 세부 묘사가 더 뛰어난 것은 아닐 수 있습니다.
* **형식**: PNG / JPEG / GIF / SVG, 투명 배경 및 24시간 URL을 지원합니다. **GIF / SVG는 이 라우트에서 네이티브로 지원되며 2.5-all에서는 사용할 수 없습니다.**
* **중국어**: 중국어 prompt를 네이티브로 지원하며 포스터, 안내 표지판, 인포그래픽의 텍스트 렌더링이 뛰어납니다.

> [!NOTE]
>
> 모델 가격은 공식 가격표를 따르며 변경될 수 있습니다. 여기에 표시된 가격은 참고용이며, 상단 탐색 메뉴의 **모델 요금** 탭이 기준입니다: [모델 요금](https://docs.apiyi.com/ko/models/index.md).

> [card] GIF 루프
>
> 네이티브 `output_format=gif`입니다. 프레임 수와 재생 시간은 정확하며, 크기는 업스트림에서 결정됩니다.

> [card] SVG 벡터
>
> 네이티브 `output_format=svg`입니다. 진정한 벡터이며, `viewBox`은 `size`를 따르고 2K–8K를 지원합니다.

> [card] ChatGPT 네이티브 품질
>
> 1536까지는 ChatGPT 웹의 외관과 지문을 유지하며, 품질 등급 중 가장 잘 제어할 수 있습니다.

> [card] 2K/4K 대형 캔버스 호환성
>
> 일반적인 크기를 정확히 지원하는 초해상도입니다. 크기가 커진다고 더 세밀해지는 것은 아닙니다.

> [!NOTE]
>
> **2K/4K 이해하기**: 더 큰 캔버스가 필요한 포스터, 인쇄물, 대형 화면에 사용하세요. 1.5K보다 더 선명한 것은 아니며, 더 많은 세부 묘사를 제공한다고 보장하지 않습니다. 안정적인 품질을 원한다면 **1536(약 1.5K) 이하**로 유지하세요.

## 빠른 시작

### 텍스트로 이미지 생성 (curl)

```bash theme={null}
curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A beige paper-textured autumn reading club poster, vertical Chinese title in the center, hand-drawn maple leaf at the bottom right",
    "size": "1536x1024",
    "response_format": "b64_json"
  }'
```

기본값은 `b64_json`입니다(`data:` 접두사가 없는 원시 base64). 약 24시간 후 만료되는 서명된 링크를 받으려면 `"response_format": "url"`을 전달하십시오. 해당 링크의 이미지를 즉시 다운로드하여 다시 호스팅하십시오.

### 이미지 편집 (Python, 멀티파트)

```python theme={null}
import base64
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
    timeout=600,
)

with open("input.png", "rb") as f:
    result = client.images.edit(
        model="gpt-image-2.6-all",
        image=f,
        prompt="Replace the background with light gray, keep the subject and text",
        size="1536x1024",
    )

image_bytes = base64.b64decode(result.data[0].b64_json)
with open("edited.png", "wb") as f:
    f.write(image_bytes)
```

## 기능

| 기능 | 지원 | 참고 |
| - | - | - |
| 텍스트로 이미지 생성 | ✅ | `/v1/images/generations` |
| 이미지 편집 | ✅ | `/v1/images/edits`을 통한 단일 이미지 / 마스크 / 여러 참조 이미지 |
| `size` | ✅ | 네이티브 긴 변 512–1536; 2K/4K 초해상도 |
| 네이티브 ChatGPT 품질 (지문) | ✅ ≤1536 | 2K/4K 초해상도는 네이티브 수준의 세부 묘사나 지문을 보장하지 않습니다 |
| `n` | ✅ 1–10 | 이미지별 과금; 2K `n=2`는 이미지 두 개를 반환했습니다 |
| 출력 형식 | ✅ PNG / JPEG / GIF / SVG | **WebP는 지원되지 않으며** 400을 반환합니다 |
| 투명 배경 | ✅ 최대 2K | `background=transparent` + PNG; 4K는 불안정합니다 |
| GIF | ✅ | `output_format=gif`이 필요합니다; `size`은 적용되지 않습니다 |
| SVG | ✅ | 2K–8K, `viewBox`은 `size`을 따릅니다 |
| URL 응답 | ✅ | `response_format=url`은 기본 그룹에서 작동합니다 |
| `quality` | ⚠️ 허용됨 | `low`는 2K에서 2048x1153을 반환할 수 있습니다; 이에 의존하지 마십시오 |
| mask | ⚠️ 허용됨 | 편집이 마스크 내부로 제한되는 것을 보장하지 않습니다; 대상 영역을 설명하십시오 |

## 크기

### 네이티브 범위(≤1536, ChatGPT 웹 네이티브)

| 가로세로 비율 | 일반적인 `size` 값 |
| - | - |
| 1:1 | 512x512, 768x768, 896x896, 1000x1000, 1024x1024, 1536x1536 |
| 4:3 / 3:4 | 1024x768, 1536x1152, 768x1024, 1152x1536 |
| 3:2 / 2:3 | 1024x683, 1536x1024, 683x1024, 1024x1536 |
| 16:9 / 9:16 | 1280x720, 1536x864, 720x1280, 864x1536 |
| 3:1 / 1:3 | 1536x512, 512x1536 |
| 비표준 | 긴 변이 512–1536이고 가로세로 비율이 ≤3:1인 모든 정수 값이 정확히 반환됩니다 |

* 16/64 정렬은 필요하지 않습니다. `1537`, `1600x900` 및 `1920x1080`는 네이티브 경로에서 거부됩니다.
* `size=auto`은 상위 단계에서 결정됩니다. 1312x1199, 1402x1122 및 1448x1086이 확인되었지만, **고정된 값은 보장되지 않습니다**.
* 네이티브 경로에서는 응답의 `size`이 실제 출력 크기와 같습니다.

### 초고해상도 범위(2K / 4K, 대형 캔버스 호환성)

2K/4K는 대형 캔버스를 위해 긴 변을 2048/4096으로 확대하는 초고해상도를 사용합니다. **크기가 크다고 해서 더 세밀한 것은 아닙니다**. 네이티브 픽셀이 아니며 1536 네이티브 등급보다 더 선명하다고 보장되지 않습니다. 측정 결과는 다음과 같습니다.

| 요청한 `size` | 실제 출력 | 참고 |
| - | - | - |
| 2048x2048 | 2048x2048 | 2K 정사각형 |
| 2048x1152 | 2048x1152 | 16:9 |
| 2048x1536 | 2048x1536 | 4:3 |
| 1920x1080 | 1920x1080 | 정확함 |
| 1600x900 / 3000x2000 | 정확함 | — |
| 2000x2000 / 1792x1024 / 1024x1792 | 정확함 | — |
| 3840x2160 | 3840x2160(일반적) / 4096x2731(간헐적) | 4K 16:9 |
| 4096x4096 / 3840x3840 / 3200x3200 | 2880x2880 | 정사각형 상한은 2880 |
| 1152x2048 | 1152x2048(일반적) / 1365x2048(간헐적) | 9:16은 2:3으로 조정될 수 있음 |
| 4096x1024 | **400** | 3:1보다 넓으므로 거부됨 |
| 3840x2160 + 투명 | 높이가 달라지는 4096 긴 변 | **`size`은 적용되지 않습니다**. 보장하지 마십시오 |

> [!WARNING]
>
> 2K/4K 응답에는 **`size` 필드가 포함되지 않을 수 있으며**, 가로세로 비율 조정으로 인해 `1365x2048` 또는 `4096x2731`가 생성될 수 있습니다. **요청한 `size`을 신뢰하지 말고 항상 실제 이미지 크기를 확인하십시오**.

### 크기 선택

* **최상의 ChatGPT 네이티브 느낌 / 안정적인 품질**: `size`을 **1536** 이하로 유지하십시오. 약 1.5K가 이상적입니다. ChatGPT 특유의 특징이 있는 가장 제어하기 쉬운 등급입니다.
* **2K 대형 캔버스 호환성**: `2048x2048`, `2048x1152`, `2048x1536`을 사용하십시오. 일반적인 크기는 정확하지만 1.5K보다 더 세밀한 결과를 기대하지 마십시오.
* **4K 가로형**: `3840x2160`을 사용하십시오. 일반적으로 3840x2160이 반환되며, 간헐적으로 4096x2731이 반환됩니다. 실제 픽셀을 확인하십시오.
* **대형 정사각형**: 상한은 **2880**이며, `4096x4096`는 2880x2880으로 반환됩니다.
* **4:1 배너**: 지원되지 않습니다. `4096x1024`은 400을 반환합니다.

## 형식

| 형식 | 요청 | 참고 |
| - | - | - |
| PNG | 기본값 | 투명 배경 지원, 무손실 |
| JPEG | `output_format=jpeg` | 파일 크기가 작으며, 투명 배경은 지원되지 않습니다 |
| GIF | `output_format=gif` | 프레임 매개변수가 필요하며, 출력 크기는 상위 단계에서 결정됩니다 |
| SVG | `output_format=svg` | 진정한 벡터 형식이며, `viewBox`은 `size`을 따릅니다 |
| WebP | ❌ | 400 오류를 반환하므로 전송하지 마세요 |

* **투명 배경**: `background=transparent` + PNG. 2K에서는 결과가 약 40%의 완전 투명 픽셀을 포함하는 RGBA입니다. **4K 투명 출력은 `size`을 따르지 않으며, 크기는 보장되지 않습니다.**
* **URL**: `response_format=url`은 `Default` 그룹에서 작동하며, `Image2_OSS` 그룹은 필요하지 않습니다. 링크는 24시간 유효한 서명된 URL입니다.
* **WebP 미지원**: 오류는 `output_format 'webp' is not supported; use png, jpeg, gif or svg`입니다.

## GIF

```bash theme={null}
curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A looping animation of a yellow doll frowning, puffing its cheeks and stomping, pure white background, seamless loop",
    "size": "2048x2048",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 150
  }'
```

* **`output_format=gif`은 필수입니다**. 프롬프트에서 루프만 요청하고 형식을 지정하지 않으면 호환성 계층이 PNG를 예상하므로 요청이 502 오류로 실패합니다 `image 1 is gif, png was asked for`.
* `frame_count` / `frame_duration_ms`는 정확히 적용됩니다. 8프레임 / 150ms, 4프레임 / 300ms, 6프레임 / 120ms 모두 요청과 일치했습니다.
* **`size`는 출력 크기를 결정하지 않습니다**. 1K 결과에는 384x512, 507x506, 619x623이 포함되었고, 2K 결과는 327x585, 4K 결과는 621x621이었습니다. **프레임 수와 지속 시간만 보장됩니다.**
* GIF 크기를 고정하려면 생성 후 클라이언트에서 크기를 조정하거나 자르십시오.

## SVG

```bash theme={null}
curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A flat rocket icon, exactly three colors, no text",
    "size": "2048x2048",
    "output_format": "svg"
  }'
```

* **진정한 벡터**: 응답은 비트맵이 아닌 `<svg>` 텍스트입니다. 2048², 3840x2160, 4096², 6144² 및 8192² 모두 통과했습니다.
* **`viewBox`는 `size`를 따릅니다**: 2048x2048은 `viewBox="0 0 2048 2048"`을 제공하고, 3840x2160은 `viewBox="0 0 3840 2160"`을 제공합니다.
* **`svg` 객체가 필요하지 않습니다**: `output_format=svg`이면 충분합니다. 공식 경로 또는 일부 SDK는 `"svg": {"model": "..."}`을 추가하지만, 2.6-all은 해당 필드를 **허용하지만 무시합니다**. 오류가 발생하지 않으며 결과도 변경되지 않으므로 이에 의존하지 마십시오.
* 출력에는 `<script>` 또는 삽입된 래스터 이미지가 포함되지 않습니다.

## 이미지 편집

* **엔드포인트**: `POST /v1/images/edits`, `multipart/form-data`.
* **단일 이미지 / 마스크 / 여러 참조 이미지**를 사용할 수 있습니다. 마스크는 참조 이미지로 취급됩니다. **편집 결과가 마스크 안에만 유지되는 것은 보장되지 않으므로**, 변경할 부분과 유지할 부분을 설명하십시오.
* 명시적인 `size`는 정확히 적용됩니다. 2K/4K도 포함됩니다(2048x2048 및 3840x2160 모두 확인됨).
* `size`이 없거나 `auto`인 경우, 입력의 종횡비를 유지하면서 출력 크기가 약 **1.57 MP**로 정규화됩니다. 원본 픽셀 크기는 보장되지 않습니다.
* 참조 이미지는 두 개까지 실제로 사용할 수 있습니다. 그 이상은 클라이언트에서 합성하거나 여러 단계로 편집하십시오.

## `n` 및 응답

* `n`은 **1\~10**을 지원하며 이미지당 과금됩니다. 2K에서 `n=2`는 2048x2048 이미지 두 장을 반환했고, `n=3`는 `usage.image_count=3` 및 `output_image_tokens=8160`(3 × 2720)와 함께 이미지 세 장을 반환했습니다. 이미지당 \$0.025이므로 총 \$0.075이며, 최종 청구액은 청구 내역에 표시된 금액입니다.
* 기본값은 `b64_json`입니다. `response_format=url`은 `url`만 반환하며, 둘 다 반환하지는 않습니다.
* 일반적인 응답 필드: `created`, `data[]`, `usage`. **2K/4K에서는 `size` 필드가 누락될 수 있으며**, 1K에서는 일반적으로 해당 필드가 그대로 반환됩니다.
* URL은 24시간 동안 유효한 서명이 적용됩니다. 만료된 후에는 새로 생성하십시오.

## 시간 초과 및 동시 실행 수

* **클라이언트 시간 초과를 600초로 설정합니다**: 1K는 약 10~~22초, 2K는 12~~24초, 4K는 15\~42초가 걸리며, 꼬리 지연 시간은 60초를 초과할 수 있습니다. 리버스 프록시, 서버리스 제한, 큐 소비자 설정도 여유 있게 조정합니다.
* **동시 실행 수**: 1K에서는 12×2, 16×1, 8×1536 모두 429 오류 없이 통과했습니다. 2K/4K는 부하 테스트를 거치지 않았으므로 동시 요청 4\~8개로 시작하고 꼬리 지연 시간을 확인합니다.
* **과금은 동기식입니다**: 요청을 보내면 과금되며, 클라이언트 연결이 끊겨도 환불되지 않고 결과도 보존되지 않습니다.

## 제한 사항

* **2K/4K는 대형 캔버스 호환성을 위한 초해상도입니다.** 네이티브 픽셀이 아니며, 1536 네이티브 티어보다 더 많은 디테일을 담는다고 보장하지 않습니다. 안정적인 품질을 위해 1536 이하로 유지하십시오.
* **2K/4K는 대체 경로에 의존합니다.** 요청은 먼저 네이티브 경로로 전달되며, 크기가 범위를 벗어나면 초해상도 경로로 전환됩니다. 대체 경로를 사용할 수 없는 경우 API가 400 `wide_fallback_required`을 반환할 수 있으므로 다시 시도하거나 1536 이하로 유지하십시오.
* **GIF 크기는 보장되지 않습니다.** 1K, 2K, 4K 모두 작은 이미지를 반환할 수 있습니다. 보장되는 항목은 프레임 수와 재생 시간뿐입니다.
* **WebP는 지원되지 않습니다.** PNG / JPEG / GIF / SVG만 지원됩니다.
* **4:1은 지원되지 않습니다.** `4096x1024`은 400을 반환합니다. 최대 종횡비는 3:1입니다.
* **투명한 4K 출력은 안정적이지 않습니다.** 긴 변이 4096인 높이를 여러 번 확인했으므로 3840x2160을 보장하지 마십시오. 투명한 출력은 2K 이하로 유지하십시오.
* **`quality`에 의존하지 마십시오.** `low` / `medium` / `high`는 허용되지만, `low`은 2K에서 2048x1153을 반환할 수 있는 반면 `medium` / `high`은 2048x2048을 반환합니다. 동일 시드에서 품질 차이는 확인되지 않았습니다.
* **`auto`를 사용한 편집은 크기를 조정합니다.** 출력은 입력 크기가 아니라 약 1.57 MP입니다.
* **콘텐츠 정책**: 상위 단계의 콘텐츠 검토에서 400 `content_policy_violation`을 반환합니다. 프롬프트를 수정한 뒤 다시 시도하십시오.

## 오류

| HTTP | `code` | 의미 | 조치 |
| - | - | - | - |
| 400 | `invalid_request_error` | 잘못된 매개변수(크기 형식, 종횡비, 형식) | 매개변수를 수정합니다 |
| 400 | `wide_fallback_required` | 2K/4K 대체 처리를 일시적으로 사용할 수 없음 | 다시 시도하거나 1536 이하의 크기를 사용합니다 |
| 400 | `content_policy_violation` | 콘텐츠 검토에서 거부됨 | prompt를 수정합니다 |
| 401 | `invalid_api_key` | 잘못된 키 또는 그룹 | `APIYI_API_KEY` 및 기본 그룹을 확인합니다 |
| 429 | `rate_limit_exceeded` | 요청 제한 또는 쿼터 한도 | 잠시 기다린 후 다시 시도합니다 |
| 502 | `image 1 is gif, png was asked for` | `output_format=gif` 없이 GIF를 요청함 | `output_format=gif`을 명시적으로 전송합니다 |

## AI 에이전트로 연동하기

**이 prompt를 Codex / Claude Code / Cursor에 복사하십시오**

먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(문서 URL 끝에 `.md` 추가), 사용 중인 기술 스택에 맞는 코드를 작성합니다. 타임아웃, 2K/4K 검증, GIF 형식 및 WebP 제한 사항이 모두 반영되어 있습니다.

요구 사항은 총 9개입니다. 아래 버튼을 사용하여 전체 prompt를 복사하십시오.

이 프로젝트에 gpt-image-2.6-all의 텍스트 기반 이미지 생성 및 이미지 편집 기능을 연동하거나 관련 문제를 해결하십시오.

먼저 문서를 읽으십시오. [https://docs.apiyi.com/en/api-capabilities/gpt-image-2-all/gpt-image-2-6-all.md](https://docs.apiyi.com/en/api-capabilities/gpt-image-2-all/gpt-image-2-6-all.md) 에서 이 페이지의 일반 텍스트 버전을 가져오십시오. 자세한 내용은 텍스트 기반 이미지 생성 및 이미지 편집 페이지 끝에도 `.md`를 추가하여 확인하십시오.

요구 사항:

1. 타임아웃: 클라이언트 타임아웃을 600초로 설정하십시오. 이미지 API는 동기식이며 작업 ID가 없습니다. 클라이언트 연결이 끊기면 결과는 유실되지만 요청에는 여전히 요금이 부과됩니다. 리버스 프록시, 게이트웨이 및 서버리스의 제한도 완화하십시오.

2. 렌더링: 기본값은 base64입니다(`b64_json`, `data:` 접두사 없음). `response_format: "url"`를 전달하면 24시간 동안 유효한 서명된 링크를 받을 수 있습니다. 기본값에 의존하지 말고 **항상 `response_format`를 명시적으로 전달하십시오**. URL 모드에서는 즉시 다운로드하여 자체 호스팅하십시오.

3. 크기: 긴 변이 512–1536인 경우 네이티브 해상도를 지원하며, 가로와 세로는 임의의 정수로 지정할 수 있고 종횡비는 최대 3:1입니다. 2K/4K는 대형 캔버스 호환성을 위한 초해상도 처리이며, 네이티브 픽셀 해상도가 아닙니다. **2K/4K 응답에는 `size`가 누락될 수 있으므로 실제 이미지 크기를 확인하십시오.** `4096x1024`처럼 3:1을 초과하는 비율은 400을 반환합니다.

4. GIF: `output_format=gif`와 함께 `frame_count` / `frame_duration_ms`를 전달하십시오. **`size`는 GIF 크기를 결정하지 않습니다**. 픽셀 크기를 제어하는 데 사용하지 마십시오.

5. SVG: `output_format=svg`를 전달하십시오. `viewBox`는 `size`를 따르며, 별도의 `svg` 객체는 필요하지 않습니다. 결과는 비트맵이 아닌 실제 벡터입니다.

6. 투명 배경: `background=transparent` + PNG를 사용하고, 가급적 2K 이하로 설정하십시오. 4K 투명 이미지의 크기는 불안정하므로 3840x2160을 보장하지 마십시오.

7. `n`는 1–10을 지원하며 이미지당 요금이 부과됩니다. `quality`는 허용되지만 이에 의존하지 마십시오. `low`는 2K에서 2048x1153을 반환할 수 있습니다.

8. `APIYI_API_KEY`에서 키를 읽고 [https://api.apiyi.com/v1](https://api.apiyi.com/v1) 을 기본 URL로 사용하십시오. 키를 하드코딩하거나 커밋하지 마십시오.

9. 연동 후 텍스트 기반 이미지 생성과 편집을 각각 한 번씩 실행하고, 두 호출의 실제 이미지 크기, 지연 시간 및 비용을 보고하십시오.

> [accordion] 이 prompt로 예방할 수 있는 문제
>
> | 요구 사항 | 예방할 수 있는 문제 |
> | - | - |
> | 600초 타임아웃 | 일반적인 HTTP 클라이언트의 기본 타임아웃은 30–60초이므로 아직 생성 중인 요청을 중단합니다. 연결이 끊긴 요청에도 요금이 부과됩니다 |
> | 명시적인 `response_format` 지정 | 기본값이 변경된 전례가 있으며, 이를 지정하지 않으면 `url`와 `b64_json`를 모두 처리해야 합니다 |
> | 실제 크기 확인 | 2K/4K에서는 `size`가 누락될 수 있습니다. 9:16은 1365x2048로 조정될 수 있고, 4K는 4096x2731을 반환할 수 있습니다 |
> | GIF 형식 | `output_format=gif`를 생략하면 이해하기 어려운 메시지와 함께 502가 반환됩니다 |
> | 투명 이미지는 2K 이하로 설정 | 4K 투명 출력은 긴 변이 4096으로 바뀌며 높이는 예측할 수 없습니다 |
> | WebP 사용 금지 | PNG / JPEG / GIF / SVG만 지원됩니다. WebP는 400을 반환합니다 |

## 자주 묻는 질문

### 2K/4K는 기본 해상도인가요?

아닙니다. 2K/4K는 기본 세부 묘사가 아니라 크기 및 대형 캔버스 호환성 문제를 해결하기 위해 초해상도를 사용합니다. 기본 품질은 1536 이하이며 ChatGPT 핑거프린트가 포함됩니다. 안정적인 품질을 원한다면 약 1.5K를 유지하고, 포스터와 인쇄물에는 2048–3840을 사용하세요.

### 2K/4K 응답에서 `size`이 누락되는 이유는 무엇인가요?

2K/4K는 초해상도 경로를 통해 제공되며, 이 경로에서는 `size`이 항상 응답에 포함되는 것은 아닙니다. 1K 경로에서는 대개 포함됩니다. 요청한 `size`을 그대로 신뢰하지 말고 실제 이미지의 너비와 높이(예: PNG IHDR)를 확인하세요.

### 투명한 4K 이미지를 생성할 수 있나요?

안정적으로 생성할 수는 없습니다. 2K에서는 투명 출력이 안정적입니다(RGBA, 완전 투명 픽셀 약 40%). 4K에서는 4096x4096, 4096x3552, 4096x2731 크기가 확인된 바 있습니다. 3840x2160으로 고정하지 마세요. 투명 출력은 2K 이하로 유지하세요.

### GIF 크기를 설정할 수 있나요?

아닙니다. `size`은 GIF 출력에 영향을 주지 않습니다. 1K에서는 384x512, 507x506, 619x623이 생성되었고, 2K에서는 327x585, 4K에서는 621x621이 반환되었습니다. 프레임 수와 재생 시간만 보장됩니다. 고정 픽셀 크기가 필요하면 클라이언트에서 크기를 조정하거나 자르세요.

### WebP를 지원하나요?

아닙니다. PNG / JPEG / GIF / SVG만 지원하며, `output_format=webp`은 400을 반환합니다.

### `quality`이 중요한가요?

`low` / `medium` / `high`은 허용되지만 이에 의존하지 마세요. `low`은 2K에서 2048x1153을 반환할 수 있지만, `medium` / `high`은 2048x2048을 반환합니다. 동일한 시드에서 시각적 차이가 있는지는 확인되지 않았습니다.

### `4096x1024`이 실패하는 이유는 무엇인가요?

최대 종횡비는 3:1입니다. `4096x1024`은 4:1이므로 매개변수 유효성 검사 중에 거부됩니다. 3:1 이내의 비율(예: 최대 `4096x1536`)을 사용하거나 이미지 두 장을 이어 붙이세요.

## 관련 문서

* [텍스트 기반 이미지 생성 API](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2-all/text-to-image.md)
* [이미지 편집 API](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2-all/image-edit.md)
* [GPT-Image-2.5-All 개요](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2-all/overview.md)
* [공식 방식과 리버스 방식 비교](https://docs.apiyi.com/ko/api-capabilities/gpt-image-2/vs-gpt-image-2-all.md)
* [이미지 API 모범 사례](https://docs.apiyi.com/ko/api-capabilities/image-api-best-practices.md)


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