> ## 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-VIP 画像生成/編集

> GPTの画像生成向けリバースエンジニアリングモデル gpt-image-2-vip（Codex系）です。1画像あたり一律$0.03です。30種類の明示的なサイズ（10の比率 × 3つの解像度ティア: 1K / 2K / 4K）に対応しています。呼び出し形式は gpt-image-2-all と同じです。1画像あたり約90～150秒で、出力寸法を固定する必要があるワークロード向けです。

<Info>
  **`size` パラメータが再び利用可能になりました**（2026-07-22 更新）: `size` を明示的に渡すと、期待どおり出力寸法がロックされ、このページの 30 サイズ参照表も再び有効になります。注意: `size` は `/v1/images/generations` と `/v1/images/edits` エンドポイントでのみ動作します — **`/v1/chat/completions` のチャット エンドポイントは `size` パラメータをサポートしていない**ため、チャットベースの画像生成では寸法をロックできません。最新の状態は [最新の更新情報](/en/live) セクションを参照してください。
</Info>

<Info>
  すべての画像 API は **同期式** です — ポーリングする task ID はなく、クライアントが切断されると、リクエストはまだ課金されていても結果は失われます。このモデルでは十分に長いタイムアウトを設定してください。詳細は [Image API の基本事項とベストプラクティス](/ja/api-capabilities/image-api-best-practices) を参照してください。
</Info>

## 概要

**gpt-image-2-vip** は、Codexライン上の **GPT画像生成リバースエンジニアリングモデル** で、APIYIプラットフォームで利用できます。 [`gpt-image-2-all`](/ja/api-capabilities/gpt-image-2-all/overview) と同じ定額の **\$0.03/image** で、**リクエスト/レスポンス形式も同一** です。実質的な違いは、`vip` が **`size`フィールド** を受け付け、**30種類の一般的なサイズ（10のアスペクト比 × 3つの解像度レベル: 1K Fast / 2K Recommended / 4K Detail）** に対応していることだけで、4Kも含みます。

<Note>
  **🎨 位置づけ**: 出力サイズを固定したいときは `gpt-image-2-vip` を使ってください（Eコマースのヒーローショット、ポスターテンプレート、動画サムネイル、4K壁紙など）。`model` フィールドを `gpt-image-2-vip` に差し替えて、`size` フィールドを追加するだけです — それ以外のコード行はすべて `gpt-image-2-all` と同じです。
</Note>

<CardGroup cols={2}>
  <Card title="テキストから画像生成 API" icon="wand-sparkles" href="/ja/api-capabilities/gpt-image-2-vip/text-to-image">
    `/v1/images/generations` — テキストプロンプト + `size` で明示的な出力サイズを指定します。
  </Card>

  <Card title="画像編集 API" icon="image" href="/ja/api-capabilities/gpt-image-2-vip/image-edit">
    `/v1/images/edits` — 編集/融合指示付きの multipart アップロードです。
  </Card>
</CardGroup>

## `gpt-image-2-all` との主な違い

`gpt-image-2-vip` と [`gpt-image-2-all`](/ja/api-capabilities/gpt-image-2-all/overview) はどちらもリバースエンジニアリングされたチャネルで、価格も呼び出しコードも同じです。**互いに鏡像のような存在です** — 同じリクエストで `model` フィールドを切り替えるだけで、挙動はほぼ同一です。違いは次のとおりです。

| 項目                     | `gpt-image-2-all`                                                      | `gpt-image-2-vip`               |
| ---------------------- | ---------------------------------------------------------------------- | ------------------------------- |
| **チャネル**               | リバースエンジニアリングされた ChatGPT Web                                            | リバースエンジニアリングされた Codex ライン       |
| **価格**                 | \$0.03 / image                                                         | \$0.03 / image（全サイズ共通の定額）       |
| **`size` パラメータ**       | ❌ 受け付けません（prompt に記述してください）                                            | ✅ 4K を含む30サイズ                   |
| **4K（例: `3840x2160`）** | ❌                                                                      | ✅ 4K Detail ティア                 |
| **生成時間**               | 約30〜60秒                                                                | 約90〜150秒（公式の `gpt-image-2` と同等） |
| **`quality` パラメータ**    | ❌ 受け付けません                                                              | ❌ 受け付けません（渡さないでください）            |
| **エンドポイント**            | `/images/generations` + `/images/edits`                                | 左と同じ（同一）                        |
| **レスポンス形式**            | `b64_json`（デフォルト、raw base64、プレフィックスなし） / `url`（明示的な `response_format`） | 左と同じ                            |
| **向いている用途**            | prompt 主導で、サイズに依存しない場合                                                 | 出力サイズを固定したい場合（4K を含む）           |

<Tip>
  **一言での判断**: **厳密なサイズは不要で、最速の出力がほしい** → `gpt-image-2-all`; **固定サイズまたは 4K が必要** → `gpt-image-2-vip`; **`quality` ノブや厳密な OpenAI-API フィールド互換性が必要** → 公式の [`gpt-image-2`](/ja/api-capabilities/gpt-image-2/overview) を使ってください。
</Tip>

## 主な機能

<CardGroup cols={2}>
  <Card title="出力サイズ固定" icon="expand">
    `size`フィールドは30種類の一般的なサイズに対応します — eコマースのヒーロー画像、ポスターテンプレート、4K壁紙などを、すべて正確なピクセルで出力します。
  </Card>

  <Card title="4K高解像度" icon="image">
    4K Detailティアは 2880×2880 / 3840×2160 / 3840×1632 などをカバーし、大きな納品物に適しています。
  </Card>

  <Card title="全サイズ一律料金" icon="dollar-sign">
    1K / 2K / 4K はすべて \$0.03/画像で、4K の追加料金はありません。
  </Card>

  <Card title="-all と同じ呼び出し形式" icon="copy">
    リクエスト構造、フィールド、レスポンス形式は `gpt-image-2-all` と同一です — `model` 文字列だけでモデルを切り替えられます。
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="高品質テキスト描画" icon="type">
    中国語/英語のテキスト、看板、ポスターテキストを安定して描画 — インフォグラフィックやマーケティング素材に最適です
  </Card>

  <Card title="中国語の説明を翻訳なしでそのまま理解" icon="languages">
    翻訳なしで中国語の説明をネイティブに理解
  </Card>

  <Card title="自然言語編集" icon="message-circle">
    会話形式の説明で編集でき、マスクは不要。複数ターンの反復にも対応します
  </Card>

  <Card title="標準エンドポイント対応" icon="plug">
    OpenAI Images API の標準エンドポイント `/images/generations` と `/images/edits` に対応
  </Card>
</CardGroup>

## 価格

| モデル               | 課金     | 価格                 | 出力                                      |
| ----------------- | ------ | ------------------ | --------------------------------------- |
| `gpt-image-2-vip` | 呼び出しごと | **\$0.03 / image** | 1回の呼び出しにつき画像1枚、`size` フィールドで出力サイズを固定します |

<Info>
  **課金に関する注記**:

  * **30種類すべてのサイズで一律 \$0.03/image** — 4K Detail への追加料金はありません
  * 失敗したリクエストは課金されません（認証失敗、パラメータ検証エラー）
  * N枚の画像が必要な場合は、APIをN回並列で呼び出します
</Info>

## グループ設定

`gpt-image-2-vip` は `Default` グループ上にあります — **追加のグループは不要です**。リバースチャンネルには現在安定した供給があるため、公式リレー `gpt-image-2` のようなエンタープライズグループへのフォールバックの話はありません。

| モデル               | グループ         | 備考                                                                      |
| ----------------- | ------------ | ----------------------------------------------------------------------- |
| `gpt-image-2-vip` | `Default`    | Codex リバースライン、一律 \$0.03/img、約90–150秒                                    |
| `gpt-image-2-vip` | `image2_OSS` | **1倍のレート倍率（追加料金なし）**、決定的なURL出力 — デフォルトグループが高負荷のときでも base64 にフォールバックしません |

### 決定的なURL出力が必要ですか → `image2_OSS` グループに切り替えてください

2026年7月にデフォルトグループで計測したところ、`gpt-image-2-vip`（および `gpt-image-2-all`）は `b64_json` を返します。`response_format` を省略した場合は、画像URLを取得するには `response_format: "url"` を明示的に渡してください。デフォルトグループの出力形式は**保証されません** — これまで高負荷時には `url` が既定で、`b64_json` にフォールバックしており、チャネルのバージョンによっても変更されてきました。

ビジネスが**URL出力に依存している**場合（URLをそのままデータベースに書き込む、フロントエンドでURLからレンダリングする、base64 は受け入れられないなど）は、トークンのグループを **`image2_OSS`** に切り替えてください。これは **決定的なURL出力** のために特別に設計されたグループで、**1倍のレート倍率（追加料金なし）** で、リバースモデル `gpt-image-2-vip` と `gpt-image-2-all` の両方に有効です。応答には常に画像URLが含まれ、base64 にフォールバックすることはありません。

<Frame caption="Token creation: set billing mode to &#x22;pay-as-you-go first&#x22; and pick the image2_OSS group (1x) — use it when you need deterministic URL output">
  <img src="https://mintcdn.com/apiyillc/eNGQJU-a_dFb12gU/images/image2-oss-token-setup-20260525.png?fit=max&auto=format&n=eNGQJU-a_dFb12gU&q=85&s=727f61464cc759006a59e8de6ceccd32" alt="トークン作成画面: 課金モードは従量課金を先に、グループ image2_OSS（1倍のレート倍率）、画像URLを出力するグループ、gpt-image-2-all と gpt-image-2-vip に適しています" width="1278" height="846" data-path="images/image2-oss-token-setup-20260525.png" />
</Frame>

<Tip>
  **上級編（`gpt-image-2-all` と 公式リレー `gpt-image-2` も使う場合）**: トークンがこの3モデルすべてをカバーするなら、トークンのグループ優先順位を次のように設定してください。

  * **第一優先**: `image2Enterprise`（1.2倍のエンタープライズグループ、公式リレー専用の安定レーン）
  * **デフォルトのフォールバック**: `Default`（2つのリバースモデルはどちらもここにあり、モデルごとにルーティングされます）

  結果として、公式リレー `gpt-image-2` は安定性のためにエンタープライズレーンを使い、2つのリバースモデルはデフォルトグループにとどまります。1つの token で3つすべてをカバーでき、干渉はありません。
</Tip>

📖 `image2Enterprise` グループについて: [/en/live/2026-04/image2-enterprise-stable](/en/live/2026-04/image2-enterprise-stable)

## 技術仕様

| 属性                 | 値                                                                                     |
| ------------------ | ------------------------------------------------------------------------------------- |
| **モデル名**           | `gpt-image-2-vip`                                                                     |
| **チャネル種別**         | 公式リバースエンジニアリング（Codex系）                                                                |
| **価格**             | \$0.03 / image、1回の呼び出しごと（全サイズ一律）                                                      |
| **生成時間**           | **約90〜150秒**（公式の`gpt-image-2`と同等；`gpt-image-2-all`の30〜60秒より遅い）                        |
| **`size`パラメータ**    | ✅ 30種類: 10比率 × 3解像度階層（1K 高速 / 2K 推奨 / 4K 詳細）                                          |
| **4K対応**           | ✅ 4K 詳細階層（例: `3840x2160` / `2880x2880`）                                               |
| **`quality`パラメータ** | ❌ 非対応、渡さないでください                                                                       |
| **`n`パラメータ**       | ❌ 非対応、1回の呼び出しにつき単一画像のみ                                                                |
| **デフォルト応答形式**      | `b64_json`（生のbase64、**`data:`プレフィックスなし**、2026-07確認済み；常に`response_format`を明示的に渡してください） |
| **任意形式**           | `url`（R2 CDN加速リンク、**有効期限は約1日**、明示的な`response_format: "url"`が必要）                       |
| **中国語入力**          | ✅ ネイティブ対応                                                                             |
| **対応機能**           | テキストから画像生成、単画像編集、複数画像融合、自然言語編集                                                        |

<Warning>
  **⏰ 画像URLの有効期限: 約1日（デフォルト）**

  `url`フィールドは`url`モード応答内のR2 CDNリンクで、**約24時間で期限切れになります** — それ以降のリクエストは404になります。長期保存が必要な画像は、生成後できるだけ早く**ダウンロードして自分のストレージに保存**するか、`b64_json`応答形式を使用してください。
</Warning>

## エンドポイント

`gpt-image-2-vip` は、`gpt-image-2-all` とまったく同じ 2 つのエンドポイントに対応しています。必要に応じて、`model` フィールドを入れ替えて、`size` を追加するだけです:

| エンドポイント                       | 用途          | Content-Type          | 最適な用途                                                           |
| ----------------------------- | ----------- | --------------------- | --------------------------------------------------------------- |
| `POST /v1/images/generations` | テキストから画像生成  | `application/json`    | OpenAI Images API の標準フォーマット — 同じコードで公式チャネルとリバースチャネルの両方にアクセスできます |
| `POST /v1/images/edits`       | 画像編集（単一/複数） | `multipart/form-data` | OpenAI Images API の標準フォーマット — 同じコードで公式チャネルとリバースチャネルの両方にアクセスできます |

<Tip>
  **OpenAI Images API を使う**（`/v1/images/generations` + `/v1/images/edits`）ことをおすすめします。理由は 2 つあります:

  1. **より安定**: Images API チャネルの上流リソース供給がより豊富なため、呼び出し成功率が高いです
  2. **公式リレーとの互換性が高く、切り替えが簡単**: 呼び出し方法や `size` のようなパラメータは公式リレー [`gpt-image-2`](/ja/api-capabilities/gpt-image-2/overview) と完全に互換です。リバースチャネルがレート制限の揺らぎに遭遇した場合でも、**`model` の名前を入れ替えるだけ**でコード変更は不要です

  チャットベースのエンドポイント（`/v1/chat/completions`、現在は非推奨）もあります。詳細は下の FAQ をご覧ください。
</Tip>

<Tip>
  **ドメインの選択肢**: `api.apiyi.com` がメインドメインです。`b.apiyi.com` / `vip.apiyi.com` のような代替ゲートウェイドメインも使用できます。レスポンスの挙動は同一です。
</Tip>

## 対応サイズ（30サイズの完全版表）

`gpt-image-2-vip`は **10種類のアスペクト比 × 3つの解像度ティア = 30サイズ** をサポートします。`size: "WIDTHxHEIGHT"`（小文字ASCIIの`x`）をリクエストボディに直接指定してください。

### 1K 高速 — 下書きと低コストの反復

| 比率   | 名称     | ピクセル        |
| ---- | ------ | ----------- |
| 1:1  | スクエア   | `1280x1280` |
| 2:3  | ポートレート | `848x1280`  |
| 3:2  | フォト    | `1280x848`  |
| 3:4  | ポートレート | `960x1280`  |
| 4:3  | スタンダード | `1280x960`  |
| 4:5  | ソーシャル  | `1024x1280` |
| 5:4  | ラージ    | `1280x1024` |
| 9:16 | ストーリー  | `720x1280`  |
| 16:9 | ワイド    | `1280x720`  |
| 21:9 | シネマ    | `1280x544`  |

### 2K 推奨 — デフォルトのティア（本番出力の大半）

| 比率   | 名称     | ピクセル        |
| ---- | ------ | ----------- |
| 1:1  | スクエア   | `2048x2048` |
| 2:3  | ポートレート | `1360x2048` |
| 3:2  | フォト    | `2048x1360` |
| 3:4  | ポートレート | `1536x2048` |
| 4:3  | スタンダード | `2048x1536` |
| 4:5  | ソーシャル  | `1632x2048` |
| 5:4  | ラージ    | `2048x1632` |
| 9:16 | ストーリー  | `1152x2048` |
| 16:9 | ワイド    | `2048x1152` |
| 21:9 | シネマ    | `2048x864`  |

### 4K 詳細 — 大型納品物

| 比率   | 名称     | ピクセル        |
| ---- | ------ | ----------- |
| 1:1  | スクエア   | `2880x2880` |
| 2:3  | ポートレート | `2336x3520` |
| 3:2  | フォト    | `3520x2336` |
| 3:4  | ポートレート | `2480x3312` |
| 4:3  | スタンダード | `3312x2480` |
| 4:5  | ソーシャル  | `2560x3216` |
| 5:4  | ラージ    | `3216x2560` |
| 9:16 | ストーリー  | `2160x3840` |
| 16:9 | ワイド    | `3840x2160` |
| 21:9 | シネマ    | `3840x1632` |

<Info>
  **30サイズすべてで均一料金**: \$0.03/画像。4K Detail に追加料金はありません。
</Info>

<Tip>
  **ティアの選び方**:

  * **1K 高速** — 下書き、サムネイル、A/Bテスト。最速で出力できます（価格は均一ですが、反復サイクルは短くなります）。
  * **2K 推奨** — **デフォルトのティア**。eコマースのヒーローショット、ポスター、インフォグラフィックなど、本番出力の大半をカバーします。
  * **4K 詳細** — 印刷、大型ディスプレイ、動画サムネイル、デスクトップ / 屋外向け大型フォーマット。
</Tip>

**最小呼び出し例**（`size` のみを指定し、**`quality` は指定しないでください**）:

```bash theme={null}
curl "https://api.apiyi.com/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YI_API_KEY" \
  -d '{
    "model": "gpt-image-2-vip",
    "prompt": "Product shot of a white ceramic mug on a gray desk, soft natural light, clean background",
    "size": "2048x1360"
  }'
```

## ベストプラクティス

<Steps>
  <Step title="入力画像は 1.5MB 未満に圧縮してください（画像編集 / 複数画像融合）">
    アップロードする各画像は **1.5MB 未満** に圧縮してください（JPEG 品質 80-90 / 解像度を下げる）。複数画像融合でも、画像ごとに同じ上限を適用します。まれに発生する `shell_api_error` / `Unknown error` のレスポンスは、ほとんどの場合、入力が大きすぎることが原因です — 圧縮すると成功率とレイテンシが目に見えて改善します。**出力解像度は入力サイズではなく `size` フィールドで決まります** — 入力を小さくしても速くなるだけで、品質は下がりません。`4K` / `8K` を prompt に詰め込んでも 4K 画像にはなりません。解像度は prompt の飾りではなく、`size` で決まります。
  </Step>

  <Step title="成果物に応じてサイズ階層を選ぶ">
    1K Fast は下書き向け、2K Recommended は本番向け、4K Detail は印刷 / 大型ディスプレイ向けです。料金は一律です — 必要に応じて選んでください。
  </Step>

  <Step title="サイズには小文字の ASCII x を使う">
    `"size": "1536x1024"` を送信してください — `1536×1024` ではなく、大文字の `X` でもありません。
  </Step>

  <Step title="quality や n は渡さない">
    `quality` は受け付けられません。`n` は 1 回の呼び出しにつき 1 枚しか返しません — 複数画像が必要な場合は並列で呼び出してください。
  </Step>

  <Step title="300s のタイムアウトを使う">
    通常の生成は 90–150s ですが、画像のアップロード / ダウンロード時間やピーク時のテールレイテンシでさらに長くなります。**保守的な基準として 300s を設定してください。**
  </Step>

  <Step title="必要に応じてレスポンス形式を選ぶ">
    直接の Web 表示には `b64_json` を使い、サーバー側での保存 / 転送には `url` を使ってください。
  </Step>

  <Step title="コードは -all で共有する">
    同じコードで両方に対応できます — 必要に応じて `model` を `gpt-image-2-all` と `gpt-image-2-vip` の間で切り替えてください。サイズを固定したい場合は vip を使い、最速で反復したい場合は -all に戻してください。
  </Step>
</Steps>

## エラーコードとリトライ

| ステータス          | 意味                                         | 推奨                                                                                                                                                |
| -------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`          | 30サイズのセットに含まれていない、または形式が不正です               | 上の表にある文字列をそのまま使用してください                                                                                                                            |
| `401`          | 無効な token                                  | Bearer Token を確認してください                                                                                                                            |
| `429`          | rate limit / quota を使い切りました                | 指数バックオフでリトライしてください                                                                                                                                |
| `500` (4K で散発) | OpenAI の上流側の計算変動です。4K Detail 階層でより頻繁に発生します | **2K Recommended に下げて**再試行してください。4K が必須の場合は、公式プロキシ [`gpt-image-2`](/ja/api-capabilities/gpt-image-2/overview) + `image2Enterprise` グループに切り替えてください |
| `5xx` (その他)    | 一時的な gateway/backend エラーです                 | 1〜2回リトライしてください                                                                                                                                    |
| Timeout        | Codex のピーク + 4K のロングテール                    | クライアントの timeout を **≥ 300s** に設定してください（保守的な設定）                                                                                                    |

<Info>
  **クライアントの推奨設定**:

  * Request timeout は **300秒から** にしてください（保守的です。通常は90〜150秒ですが、4K Detail + ピーク時のロングテールではさらに長くなります）
  * 5xx と timeout には **指数バックオフ** を使用してください（2〜3回のリトライを推奨します）
  * デバッグ用に `request-id` response header をログに記録してください
</Info>

## よくある質問

<AccordionGroup>
  <Accordion title="vip と -all でコードを共用できますか？">
    **はい、ほぼ同じです。** 両方のエンドポイント（`/v1/images/generations`, `/v1/images/edits`）は、リクエストフィールド、レスポンスフィールド、そして `b64_json` の prefix 挙動を共有しています。違いは次の 2 点だけです。

    1. `model` フィールド: `gpt-image-2-vip` ↔ `gpt-image-2-all`
    2. `size` フィールド: vip は 30サイズセットを受け付けますが、-all は `size` を拒否します（サイズは代わりに prompt に入ります）

    実践的なパターン: 1つのコードベースに `if model == 'vip': payload['size'] = ...` スイッチを用意してください。
  </Accordion>

  <Accordion title="vip がこんなに遅いのはなぜですか？">
    `gpt-image-2-vip` は Codex のリバースチャネルを使っています — **典型的には 90〜150 秒**で、公式の `gpt-image-2`（100〜120 秒）と同程度であり、ChatGPT-web-line `gpt-image-2-all`（30〜60 秒）より遅いです。**レイテンシーに敏感**なワークロードでは、`gpt-image-2-all` を優先し、vip は**固定サイズまたは 4K が必要なときだけ**使ってください。
  </Accordion>

  <Accordion title="サイズは表にあるものと完全に一致していなければなりませんか？ 1024x768 を送るとどうなりますか？">
    **はい — 30サイズセットに従ってください。** リスト外のサイズは upstream の `invalid_request_error` を引き起こす可能性があります。納品物に最も近いティアを選んでください。
  </Accordion>

  <Accordion title="4K が頻繁に 500 を返すのはなぜですか？ どうすれば安定して 4K を取得できますか？">
    **症状**: 4K Detail ティア（例: `3840x2160` / `2880x2880`）では、`status_code: 500` エラーが発生しやすく、上流は `invalid_request_error` を返します。

    ```json theme={null}
    {
      "status_code": 500,
      "error": {
        "message": "An error occurred while processing your request. ... Please include the request ID xxxxxxxx in your message.",
        "type": "invalid_request_error",
        "code": null
      }
    }
    ```

    **根本原因**: **OpenAI の計算リソースの変動** — リクエストパラメータの問題ではありません。同じペイロードは通常 2K では通ります。Codex のリバースチャネルは 4K のような大きな出力により敏感で、特にピーク時間帯に起こりやすくなります。

    **対策**（コスト効率順）:

    1. **2K Recommended を優先する**（例: `2048x1360` / `2048x2048`）— 成功率が大幅に高く、料金は同じ **\$0.03/image**
    2. **入力画像数を減らす**: img2img / multi-image fusion では、Codex のリバースチャネルが大量の入力負荷に弱く、4K の失敗率がさらに上がります。各入力画像を **1.5MB 未満**に事前圧縮するのも有効です
    3. **4K を確実にしたい場合** — 公式プロキシ [`gpt-image-2`](/ja/api-capabilities/gpt-image-2/overview) + **`image2Enterprise` グループ** に切り替えてください。公式プロキシの 4K は高め（**約 \$0.3+/image**）ですが、かなり安定しており、4K 納品が絶対条件の場面に適しています。

    📖 現場メモ: [/en/live/2026-05/gpt-image-2-vip-4k-tips](/en/live/2026-05/gpt-image-2-vip-4k-tips)
  </Accordion>

  <Accordion title="入力画像は圧縮すべきですか？ prompt に 4K / 8K と書くと効果がありますか？">
    **はい、強く推奨します。** 各入力画像を **1.5MB 未満**（JPEG 品質 80-90 / 解像度縮小）に圧縮してください。散発的な `shell_api_error` / `Unknown error` 応答は、過大な入力が最も多い原因であり、圧縮すると成功率とレイテンシーが目に見えて改善します。注: 1.5MB は信頼性と速度のための**推奨上限**であり、上の FAQ にある 10MB はゲートウェイのハード上限です。

    **圧縮で品質が落ちる心配はありません** — 出力解像度は `size` パラメータで決まり、入力サイズでは決まりません。入力を小さくすると、単に処理が速くなるだけです。

    **prompt に `4K` / `8K` を詰め込んでも、実際に 4K 出力にはなりません。** prompt に `8K ultra HD` と書いていても、`size` を `1024x1024` に設定していれば、出力は依然として 1K 品質の画像になります。**4K にするには `size` フィールドで設定してください** — 1K / 2K / 4K は 30サイズセット全体で一律 \$0.03/image です。

    📖 出典: [/en/live/2026-05/gpt-image-2-vip-unknown-error](/en/live/2026-05/gpt-image-2-vip-unknown-error)
  </Accordion>

  <Accordion title="4K に本当に追加料金はありませんか？">
    **追加料金はありません。** 4K Detail ティア（`3840x2160` / `2880x2880` など）も、1K や 2K と同じ \$0.03/image です。
  </Accordion>

  <Accordion title="n に対応していますか？ n=3 を渡すとどうなりますか？">
    **いいえ。** このモデルは 1 回の呼び出しにつき 1 枚の画像を返します。複数画像が必要な場合は、**繰り返し / 同時呼び出し** を使ってください。

    ⚠️ **重要**: リクエストで `n=3` を渡すと、**課金は 0.03 × 3 = \$0.09** になりますが、**実際に返る画像は 1 枚だけ**です。無駄な課金を避けるため、`n` フィールドは外してください。
  </Accordion>

  <Accordion title="コンテンツが拒否されたり、モデルが 'I can't do that' と返した場合、課金されますか？">
    これは、**同期的な chat 風レスポンス**を使うリバースエンジニアリング済みチャネルです。結果は**異なる課金ルール**を持つ 2 つのケースに分かれます。

    **1) HTTP 5xx が返る → 課金されません**

    上流のコンテンツポリシーがリクエストを厳格にブロックすると、次のようになります。

    ```json theme={null}
    {
      "error": {
        "message": "Image was not generated as expected. Please adjust the prompt and retry (traceid: 0672821c6951af183dbf847130caaf16)",
        "localized_message": "Unknown error",
        "type": "invalid_request_error",
        "param": "",
        "code": null
      }
    }
    ```

    これらのハードエラーは**課金されません**。ユーザーに prompt の調整を依頼して再試行してください。

    **2) HTTP 200 で text の「ソフト拒否」→ 課金されます**

    モデルが会話の中でソフト拒否する場合（例: 「I can't do that」, 「すみません、このリクエストには…が含まれます」）、プロトコル上は通常の chat completion に見えるため、**課金されます**。リバースチャネルはプロトコル層では「拒否テキスト」と「画像出力」を信頼性高く区別できません。

    **なぜソフト拒否を単純に免除できないのか**

    すべてのソフト拒否を自動で免除すると、プラットフォームが失敗した上流呼び出しをすべて負担することになります。さらに重要なのは、**上流のコンテンツ安全性を頻繁に引き起こすと、供給元アカウントが BAN されるリスクも高まる**ことです。これは実際の供給側コストであり、完全には消せません。

    **統合側への推奨事項**

    * ✅ **事前フィルタとユーザー警告**: フロントエンドまたはゲートウェイでキーワード / シナリオフィルタ（実在の人物名、著作権キャラクター、センシティブな話題）を追加し、「有名人 / IP 系の話題は失敗することがあり、上流のポリシーにより課金される場合があります。」のような UI ヒントを表示してください。これにより無駄な課金を大幅に減らせます。
    * ✅ **コンシューマー向け製品では月次補填**: コンシューマー向け製品では、ユーザー入力を完全には制御できないことを理解しています。月間支出が十分大きい（**\$1000+/month**）場合は、**ログを月次でまとめて**（短レイテンシーの呼び出しは通常ソフト拒否です）サポートに連絡し、一度限りの手動クレジットを依頼できます。呼び出しごとに異議申し立てをする必要はありません。

    📖 関連: [500 エラーは通常コンテンツポリシーに引っかかったケースです（課金されません）](/en/live/2026-04/gpt-image-2-all-500-content-policy)
  </Accordion>

  <Accordion title="b64_json に data:image/png;base64, プレフィックスを付ける必要がありますか？">
    **まず判定してから処理してください。** 2026 年 7 月時点の検証では、返される `b64_json` は **`data:` プレフィックスのない生の base64** です。ファイルに書き出すにはデコードし、描画前に自分でプレフィックスを付けても構いません。**以前のバージョンにはプレフィックスが含まれていました**。コードに `startsWith('data:')` チェックを追加してください。プレフィックスがある場合は、値をそのまま `img src` として使い、ない場合は先にデコードするかプレフィックスを付けてください。これにより、プレフィックスの二重付与や、プレフィックス付き文字列をデコードして壊れた画像にしてしまうことを防げます。
  </Accordion>

  <Accordion title="参照画像の最大サイズと対応フォーマットは何ですか？">
    推奨は **1画像あたり ≤ 10MB**、フォーマットは `png` / `jpg` / `webp` です。大きすぎる画像はゲートウェイの制限に達する場合があります。複数画像融合の各画像もこの制限を満たす必要があります。
  </Accordion>

  <Accordion title="返される画像 URL はどのくらい有効ですか？ ダウンロードする必要がありますか？">
    `url` フィールドの `url` モードのレスポンスは、**約 1 日（24 時間）で失効する R2 CDN リンク**です。それ以降のリクエストは 404 になります。

    **強く推奨します**: 生成後すぐに、生成画像を **自前のオブジェクトストレージ（S3 / OSS / R2）、CDN、または database** にダウンロードして永続化してください。
  </Accordion>

  <Accordion title="streaming に対応していますか？">
    いいえ。このモデルは画像を一括で返し、streaming はサポートされていません。レイテンシーが重要な場合は、クライアント側で「生成中...」の進捗表示を出し、**300s timeout**（控えめ設定）を構成してください。
  </Accordion>

  <Accordion title="公式の OpenAI SDK は使えますか？">
    はい。`base_url` を `https://api.apiyi.com/v1` に向け、`api_key` に APIYI token を設定してください。`client.images.generate(model="gpt-image-2-vip", size="2048x1360", prompt=...)` はそのまま動作します。
  </Accordion>

  <Accordion title="/v1/chat/completions で引き続き画像を生成できますか？">
    はい、このエンドポイントはまだ動作しますが、**もはや推奨されません** — 代わりに `/v1/images/generations` と `/v1/images/edits` を使ってください（より安定しており、同じコードは公式リレーの `gpt-image-2` でも使えます）。

    chat ベースのスタイルが有効なのは、2 つのシナリオだけです。マルチターンの反復編集、またはオンライン画像 URL を直接渡す場合です。画像の意図があいまいなとき、モデルは画像ではなくプレーンテキストを返すことがあります（「画像を生成してください:」のような固定プレフィックスを prompt の先頭に付けると、意図を強められます）。

    全パラメータは [chat ベースの API リファレンス](/en/api-capabilities/gpt-image-2-vip/chat-completions) をご覧ください。
  </Accordion>

  <Accordion title="公式の gpt-image-2 に切り替えるべきなのはいつですか？">
    `quality` ノブ（low/medium/high）、マスクベースのローカルリペイント、または OpenAI API のフィールド互換性を厳密に求める場合は、[`gpt-image-2`](/ja/api-capabilities/gpt-image-2/overview) を使ってください。[公式版とリバース版の比較](/ja/api-capabilities/gpt-image-2/vs-gpt-image-2-all) もご覧ください。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

* [GPT-Image-2-All 概要](/ja/api-capabilities/gpt-image-2-all/overview) - 同価格帯の姉妹モデルで、出力がより速く、サイズ固定が不要な場合に最適です
* [⚖️ 公式版とリバース版の比較](/ja/api-capabilities/gpt-image-2/vs-gpt-image-2-all) - 公式 `gpt-image-2` との並列表比較による選定ガイド（`-all` / `-vip` をカバー）
* [Text-to-Image Playground](/ja/api-capabilities/gpt-image-2-vip/text-to-image) - `/v1/images/generations` 互換のエンドポイント、`size` を渡して寸法を固定します
* [Image Editing Playground](/ja/api-capabilities/gpt-image-2-vip/image-edit) - `/v1/images/edits` の複数画像融合と編集
* [GPT-Image-2 公式版](/ja/api-capabilities/gpt-image-2/overview) - `quality` パラメータ / マスクベースの再描画 / 厳密な OpenAI API フィールド互換性向け
* [GPT-Image シリーズ概要](/en/api-capabilities/gpt-image-series) - 公式 GPT-Image 比較
* [API マニュアル](/ja/api-manual) - 一般的な呼び出し規約

<Info>
  gpt-image-2-vip は逆向き実装のチャネル（Codex 系列）です。挙動は一致していますが、課金/機能は公式版と完全には一致しない場合があります。完全な公式 API 互換性が必要な場合は、[`gpt-image-2`](/ja/api-capabilities/gpt-image-2/overview) を使用してください。
</Info>
