> ## 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、画像1枚あたり$0.025、10～46秒。指紋付きで最大1536のネイティブChatGPT品質、ネイティブGIF / SVG、大きなキャンバスとの互換性を実現する2K/4K超解像、透明な背景、複数画像の編集に対応します。 > [!NOTE] > > すべての画像APIは**同期処理**です。タスクIDはないため、リクエストの課金中にクライアントが切断されると、結果は失われます。余裕のあるタイムアウトを設定してください（600秒を推奨）。[画像APIのベストプラクティス](https://docs.apiyi.com/ja/api-capabilities/image-api-best-practices.md)をご覧ください。 ## 概要 **gpt-image-2.6-all** は、Images 2.6 を基盤とする、APIYI の **ChatGPT Web リバースルート上の GPT 画像生成モデル**です。旧 `-all` ルートではプロンプト内のサイズヒントしか受け付けませんでしたが、このルートでは **`size`、`n`、`background`、`output_format` を実際に反映**し、GIF、SVG、複数画像の編集にも対応します。サイズ、フォーマット、画像数を固定する必要がある本番コードに適しています。 このルートが特に優れている点は、\*\*GIF、SVG、そして 1536 以下でのネイティブ ChatGPT 品質（フィンガープリント付き）\*\*の3つです。2K/4K は **大きなキャンバスとの互換性を確保するための超解像度ティア**であり、サイズは大きくなりますが、必ずしもより詳細になるわけではありません。品質を重視する場合は、1.5K 前後にしてください。 標準の OpenAI 画像 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 Web の品質とフィンガープリントを維持します。**2K/4K は超解像度**であり、1.5K より詳細になるとは限らず、大きなキャンバスサイズの問題を解決するものです * **フォーマット**: PNG / JPEG / GIF / SVG、透明背景、24時間有効なURLに対応します。**GIF / SVG はこのルートのネイティブ機能であり、2.5-all では利用できません** * **中国語**: 中国語のプロンプトにネイティブ対応し、ポスター、看板、インフォグラフィックでのテキスト描画に優れています > [!NOTE] > > モデル料金は公式料金表に従い、変更される場合があります。ここに記載されている料金は参考情報です。トップナビゲーションの **モデル料金**タブが正式な情報源です。[モデル料金](https://docs.apiyi.com/ja/models/index.md)。 > [card] GIFループ > > ネイティブの `output_format=gif` に対応します。フレーム数と再生時間は正確で、サイズはアップストリーム側で決定されます。 > [card] SVGベクター > > ネイティブの `output_format=svg` に対応します。真のベクター形式で、`viewBox` は `size` に従い、2K～8K です。 > [card] ネイティブ ChatGPT 品質 > > 1536 までは ChatGPT Web の外観とフィンガープリントが維持され、最も制御しやすい品質ティアです。 > [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`（生のbase64で、`data:`プレフィックスはありません）。約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`では画像が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を返す場合があります。この指定に依存しないでください | | マスク | ⚠️ 受け付け可能 | 編集がマスク内に収まることは保証されません。対象領域を記述してください | ## サイズ ### ネイティブ範囲（≤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 フレーム / 150 ms、4 フレーム / 300 ms、6 フレーム / 120 ms は、いずれもリクエストどおりでした。 * **`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" }' ``` * **真のベクター**: 応答はビットマップではなく``テキストです。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はそのフィールドを**受け付けますが無視します**。エラーにはならず、結果も変わらないため、これに依存しないでください。 * 出力には`