GPT-Image-2.5-All 画像生成/編集

すべての画像APIは同期型です。ポーリングするためのタスクIDはなく、クライアントが切断されると、リクエストが処理中でも結果は失われ、課金は発生します。このモデルでは十分に長いtimeoutを設定してください。詳細は Image API Essentials & Best Practices をご覧ください。

概要

gpt-image-2.5-all および gpt-image-2-all は、APIYIの GPT 画像生成リバースエンジニアリングモデル（ChatGPT Web系統）です。ChatGPT Webアプリ全体がImages 2.5に移行したため、gpt-image-2-all はすでに2.5画像を生成します。新しい gpt-image-2.5-all という名称は、そのアップグレードを明確にしたものに過ぎません。両名称は価格と挙動が共通しており、相互に互換性があります。新規プロジェクトでは gpt-image-2.5-all をご使用ください。1回の呼び出しあたり $0.025/image という極めて競争力の高い価格設定（2026-10-10に$0.03から値下げ）で、約30〜60秒で画像を生成し、テキスト画像生成 / 単一画像編集 / 複数画像合成 / 自然言語編集をサポートしています。テキストレンダリングの再現性が高く、中国語のpromptもネイティブにサポートしています。

🎨 主な特徴: 一律 $0.025/image のレートで利用できる、信頼性の高いリバースエンジニアリングチャネルです。size、quality、n などのパラメータを気にする必要はなく、prompt内でサイズやスタイルを指定するだけです。OpenAI Images APIの標準エンドポイントである /v1/images/generations（テキスト画像生成）および /v1/images/edits（画像編集）を使用します。出力サイズや4Kを固定する必要がありますか？ 姉妹モデルのgpt-image-2-vipに切り替えてください。呼び出し形式は同一で、size フィールドが1つ追加されるだけです。

テキスト画像生成 API

/v1/images/generations — テキストのpromptから画像を生成します。

画像編集 API

/v1/images/edits — 編集・合成指示を含むマルチパートアップロード。

AIエージェントに統合を任せる

このpromptをコピーしてCodex / Claude Code / Cursorに貼り付けてください

まずこのページのプレーンテキスト版を取得し（任意のドキュメントURLに.mdを追加）、プロジェクト独自の技術スタックでコードを記述します。タイムアウト、base64レンダリング、アップロード圧縮、そしてこのモデルで拒絶されるパラメータはあらかじめ要件に組み込まれています。

このプロジェクトにgpt-image-2-allのText-to-Image（テキストからの画像生成）および画像編集を統合 / トラブルシューティングしてください。

コードに触れる前にドキュメントを読んでください：このページのプレーンテキスト版を取得するには https://docs.apiyi.com/en/api-capabilities/gpt-image-2-all/overview.md を取得してください。より詳細なパラメータについては、.mdを…

タイムアウト：クライアントのタイムアウトを360秒に引き上げてください。画像APIは同期的です — タスクIDが存在しないため、クライアントが切断されると結果が失われます…

合計6つの要件があります。以下のボタンを使用してprompt全体をコピーしてください。

このpromptが防ぐトラブル

要件	回避できる落とし穴
タイムアウトを360秒に引き上げ	主要なHTTPクライアントはデフォルトで30〜60秒のタイムアウトが設定されており、サーバーが正常に生成中であってもリクエストが切断されてしまいます — しかも切断されたリクエストでも課金されます。画像APIの基本とベストプラクティスを参照してください
`response_format`を明示的に送信	デフォルトは過去に変更されたことがあります。明示しない場合、`url`と`b64_json`の両方の形式を処理する必要があります
`n`を絶対に送信しない	3を送信すると3枚分課金されますが、1枚しか返されません
`size` / `quality`を絶対に送信しない	このモデルは両方を拒絶します。サイズは代わりにpromptプレフィックスから決定されます
アップロード前の圧縮	スマートフォンの写真は日常的に4〜5MBに達し、さらにbase64エンコードによって約33%サイズが増加します。画像の圧縮と出力解像度を参照してください

主な機能

非常に競争力のある価格設定

1画像あたり一律$0.025、解像度による階層分けがなく、コストを予測しやすい料金体系です

高度なテキストレンダリング

中国語や英語のテキスト、看板、ポスターの文字を安定してレンダリング — インフォグラフィックやマーケティング素材に最適です

中国語プロンプトに対応

翻訳を介さずに中国語の記述をネイティブに理解します

複数画像の融合

複数の参照画像をサポートしており、プロンプト内で「image1/image2/image3」として参照できます

より高速な出力

約30〜60秒で生成 — gpt-image-2-vipと公式リレーのgpt-image-2の双方よりも高速です

R2 CDNによる高速化

低レイテンシーなグローバル配信を行うR2 CDNリンクを取得するには、明示的にresponse_format: "url"を渡します

自然言語による編集

会話形式の説明で編集可能で、マスクは不要、マルチターンの反復処理をサポートしています

標準エンドポイントのサポート

OpenAI Images APIの標準エンドポイント/images/generationsおよび/images/editsと互換性があります

料金

モデル	課金方式	料金	出力
`gpt-image-2-all`	呼び出しごと	$0.025 / 画像	1回の呼び出しにつき1枚
`gpt-image-2.5-all`	呼び出しごと	$0.025 / 画像 (-all と同一)	1回の呼び出しにつき1枚（GPT-Image 2.5 準拠）

課金に関する注意事項:

一律料金です。解像度、品質、prompt の長さによる料金設定の違いはありません
失敗したリクエスト（認証エラー、パラメータ検証エラー）には課金されません
N枚の画像が必要な場合は、API を並行して N 回呼び出してください

モデルの料金は公式のものと連動しており、プロバイダーによる改定時に変更される場合があります。上記の表は参考用です。正式な情報については、上部ナビゲーションのモデル料金タブをご確認ください: モデル料金。

2026-10-10からの値下げ: $0.03 → $0.025/画像（gpt-image-2-all と gpt-image-2.5-all の両方に適用）。

理由: -all シリーズは単体でも高い画像品質を提供し、-vip シリーズよりも安定しています。-vip はプロバイダー側のリスク管理の影響をより受けやすい傾向にあります（メンテナンスおよび容量追加は継続しており、-vip も引き続きご利用いただけます）。この値下げは、日常的な画像生成において -all を手軽なデフォルトの選択肢としていただくことを目的としています。
唯一のトレードオフ: 出力解像度は 1K〜1.5K であり、2K / 4K には対応していません。日常的な生成にはこれで十分対応可能です。固定サイズや 4K が必要な場合は、-vip または公式リレーをご利用ください。
実際にはさらに安価: $0.025 は割引前の価格です。チャージボーナス（10%〜20% の追加クレジット）と組み合わせることで、実質的なコストをさらに抑えることができます。

姉妹モデル: gpt-image-2-vip（Adobe リバース回線（Firefly））— $0.03/画像、30種類の明示的なサイズに対応（4K を含む）、同一の呼び出し形式です。出力サイズを固定したい場合や 4K が必要な場合は、こちらに切り替えてください。

グループの設定

gpt-image-2-allはDefaultグループに存在するため、追加のグループは不要です。リバースチャネルは現在安定して供給されているため、公式リレーのgpt-image-2のようなエンタープライズグループへのフォールバック構成は存在しません。

モデル	グループ	備考
`gpt-image-2-all`	`Default`	ChatGPT-webリバース、一律$0.025/画像、約30〜60秒
`gpt-image-2.5-all`	`Default`	同じラインのGPT-Image 2.5バージョン、一律$0.025/画像、-allと同じグループ
`gpt-image-2-all`	`image2_OSS`	1倍レート倍率（追加料金なし）、確定的なURL出力 — デフォルトグループの負荷が高い場合でもbase64にフォールバックしません

確定的なURL出力が必要な場合 → `image2_OSS`グループへの切り替え

デフォルトグループにおいて2026年7月時点で計測された結果では、response_formatを省略した場合、gpt-image-2-all（およびgpt-image-2-vip）はb64_jsonを返します。画像のURLを取得するには明示的にresponse_format: "url"を渡してください。デフォルトグループの出力形式は保証されていません — これまではデフォルトでurlとなり、高負荷時にはb64_jsonへフォールバックしていましたが、チャネルのバージョンによって変更されてきました。業務がURL出力に依存している場合（データベースへのURLの直接書き込み、URLによるフロントエンド描画、base64が許容されない場合など）、tokenのグループを**image2_OSSに切り替えてください。これは確定的なURL出力**のために特別に構築されたグループであり、**1倍レート倍率（追加料金なし）**で、両方のリバースモデルgpt-image-2-allおよびgpt-image-2-vipに有効です。レスポンスに常に画像URLが含まれ、base64にフォールバックしないことが保証されます。

token作成画面：課金モードは従量課金を優先、グループはimage2_OSS（1倍レート倍率）、画像URLを出力するグループで、gpt-image-2-allおよびgpt-image-2-vip向け — Token creation: set billing mode to "pay-as-you-go first" and pick the image2_OSS group (1x) — use it when you need deterministic URL output

高度な設定（gpt-image-2-vipおよび公式リレーのgpt-image-2も併用する場合）：tokenで3つのモデルすべてをカバーする場合は、tokenのグループ優先度を次のように設定してください。

第一優先：image2Enterprise（1.2倍エンタープライズグループ、公式リレー専用の安定レーン）
デフォルトフォールバック：Default（両方のリバースモデルがここに属し、モデルごとにルーティングされます）

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

📖 image2Enterpriseグループについて：/en/live/2026-04/image2-enterprise-stable

技術仕様

属性	値
モデル名	`gpt-image-2-all`
チャネルタイプ	公式リバースエンジニアリング（ChatGPT Web）
料金	$0.025 / 画像、呼び出しごと
生成時間	約30〜60秒
出力解像度	明示的なサイズパラメータなし、アダプティブ（promptで指定）
デフォルトのレスポンス形式	`b64_json`（生のbase64、`data:`プレフィックスなし、2026-07検証済み。常に明示的に`response_format`を渡してください）
オプションの形式	`url`（R2 CDN高速化リンク、有効期間は約1日、明示的な`response_format: "url"`の指定が必要）
中国語prompt	✅ ネイティブ対応
機能	テキストからの画像生成、単一画像の編集、複数画像の合成、自然言語編集

このモデルは出力サイズがアダプティブであり、公式のgpt-image-2 APIと同等ではありません。出力サイズを厳密に固定したい場合や4Kが必要な場合は、gpt-image-2-vip（Adobeリバース回線（Firefly）、4Kを含む30種類の明示的なサイズに対応）をご利用ください。公式APIと完全な互換性が必要な場合は、gpt-image-2をご利用ください。

⏰ 画像URLの有効期間：約1日（デフォルト）urlモードのレスポンスにおけるurlフィールドはR2 CDNリンクであり、約24時間で失効します（それ以降のリクエストは404エラーになります）。長期保存が必要な画像（商品画像、ユーザー作品、履歴レコードなど）については、生成後できるだけ早くダウンロードし、ご自身のストレージに永続化してください。一般的な2つのアプローチ：

サーバー側でのダウンロード：レスポンスを受信したらすぐに、requests / fetchを使用して画像を取得し、S3 / OSS / R2 / ローカルディスクに保存します
b64_jsonレスポンス形式の使用：base64データとして画像を直接取得できるため、追加のクロスオリジンダウンロードを省略できます。フロントエンドでのレンダリングやファイルへの直接書き込みに最適です

エンドポイント

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

OpenAI Images APIを使用してください（/v1/images/generations + /v1/images/edits）。理由は2点あります：

より安定: Images APIチャンネルは上流リソースの供給がより豊富なため、呼び出し成功率が高くなります
公式リレーと互換性があり簡単に切り替え可能: 呼び出し方法やsizeなどのパラメータは公式リレーのgpt-image-2と完全に互換性があります — リバースチャンネルでリスクコントロールによる不安定化が発生しても、コードを一切変更することなく**model名を差し替えるだけ**で対応可能です

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

ドメインオプション: api.apiyi.comがメインドメインです。b.apiyi.comなどの代替ゲートウェイドメインを使用することもできます。レスポンスの挙動は同一です。

sizeパラメータで出力サイズを固定したいですか？ 姉妹モデルのgpt-image-2-vipをご利用ください — エンドポイントは同一で、追加のsizeフィールドが1つあるだけです（4Kを含む30種類の明示的なサイズに対応）。

サイズとアスペクト比の制御（prompt 内に記述）

gpt-image-2-all には size パラメータがありません。サイズは prompt に記述します。出力サイズを厳密に固定したい場合（EC のヒーロー画像、ポスターテンプレート、4K 壁紙など）は、代わりに gpt-image-2-vip を使用してください。

検証済みの「prompt の表現 → 実際の解像度」表

以下の 8 つの表現は、実際に安定して再現されることが確認済みです。第 1 列の表現を prompt の先頭に置くと、第 2 列に示した解像度が得られます（いずれの出力もおよそ 1.5K ピクセル帯です）。

Prompt の表現（そのまま記述）	検証済みの解像度	おおよそのサイズ	実際の比率
`横版 16:9` (Landscape 16:9)	1672 × 941	約 1.9 MB	16:9
`竖屏 9:16` (Portrait 9:16)	941 × 1672	約 2.1 MB	9:16
`4:3`	1448 × 1086	約 2.3 MB	4:3
`3:4`	1086 × 1448	約 2.5 MB	3:4
`3:2 尺寸` (3:2 size)	1536 × 1024	約 2.9 MB	3:2
`2:3 尺寸` (2:3 size)	1024 × 1536	約 3.0 MB	2:3
`2:5 竖屏` (2:5 portrait)	793 × 1983	約 1.9 MB	2:5
`5:2 横屏` (5:2 landscape)	1983 × 793	約 1.9 MB	5:2

注記:

すべての出力は 約 1.5K ピクセル帯（長辺 1500〜2000 px）です。これはモデルの実質的な上限であり、本当に「任意の解像度」ではありません。
prompt に表の表現以外を 入れない ときが、再現性が最も高くなります。ほかの構図に関する語を混ぜると、ずれが生じます。
中国語の文字列は実際に送信する値です。翻訳せず、そのまま使うことをおすすめします。

スタイル用の表現（固定解像度なし）

以下の表現には検証済みの解像度がありません。上の表と組み合わせて、スタイル修飾子としてのみ使用してください。

必要なもの	表現（スタイルのガイダンスのみ — 解像度の保証なし）
正方形	`1024×1024 square` / `1:1 square composition`
超横長バナー	`Banner 21:9 ultra-widescreen`
スタイル修飾子	`cinematic` / `phone poster` / `square composition`

ヒント: サイズや構図を表す語は、prompt の先頭に置くとより反映されやすくなります。

この表をエンドユーザーに公開する

gpt-image-2-all には size パラメータがありませんが、ユーザーに「サイズ / アスペクト比」ドロップダウンを用意して、公式の size フィールドのように見せる ことはできます。

上の表にある prompt の表現を、オプションの value として使用します（例: 横版 16:9）
ユーザーが何を得られるか分かるように、オプションラベルに 予想解像度 を表示します（例: Landscape 16:9 (1672×941)）
バックエンドでは、選択された表現をユーザーの元の prompt の先頭に付けてから API に送信します

const SIZE_OPTIONS = [
  { label: "Landscape 16:9 (1672×941)", prefix: "横版 16:9" },
  { label: "Portrait 9:16 (941×1672)",  prefix: "竖屏 9:16" },
  { label: "4:3 (1448×1086)",           prefix: "4:3" },
  { label: "3:4 (1086×1448)",           prefix: "3:4" },
  { label: "3:2 (1536×1024)",           prefix: "3:2 尺寸" },
  { label: "2:3 (1024×1536)",           prefix: "2:3 尺寸" },
  { label: "2:5 portrait (793×1983)",   prefix: "2:5 竖屏" },
  { label: "5:2 landscape (1983×793)",  prefix: "5:2 横屏" },
];

const finalPrompt = `${selected.prefix}, ${userPrompt}`;

基盤モデルは引き続き 適応的 です。ピクセル単位のわずかなずれは正常です。エンドユーザーに対して、完全一致の出力を約束しないでください。出力サイズを厳密に固定したい場合（EC のヒーロー画像、ポスターテンプレート、4K 壁紙など）は、姉妹モデル gpt-image-2-vip を使用してください。価格は同じ、呼び出しコードも同じで、追加の size フィールドが 1 つあるだけです。

ベストプラクティス

入力画像を1.5MB未満に圧縮する（画像編集 / マルチ画像融合）

アップロードする各画像は1.5MB未満（JPEG品質80〜90 / 解像度縮小）に圧縮してください。マルチ画像融合でも、1枚ごとに同じ上限を適用します。断続的なサーバー側エラーは、サイズ超過の入力が原因で起きることが最も多く、圧縮すると成功率とレイテンシが目に見えて改善します。出力解像度は入力サイズではなく prompt の表現によって決まります — 入力を小さくすると処理が速くなるだけで、品質は落ちません。prompt に4K / 8K を詰め込んでも高解像度画像にはなりません。より大きい出力を安定して得るには、上の「検証済みのprompt表現 → 実際の解像度」表の表現を使ってください。

サイズはpromptの先頭に置く

比率、解像度、構図に関する語を先頭に置くと、指示への追従性が高まります。

テキスト要素を自信を持って使う

文字描画の忠実度は大きな強みです — 中国語/英語のテキストを含む看板、ポスター、インフォグラフィックはどれもよく動作します。

マルチ画像の順序を明記する

image フィールドを繰り返す順序には意味があります。prompt では「image1/image2/image3」と明示的に参照してください。

必要に応じてレスポンス形式を選ぶ

b64_json は直接Web描画用、url はサーバー側での保存/転送用です。

300秒のタイムアウトを使う

通常の生成は30〜60秒ですが、画像のアップロード / ダウンロード時間や逆チャネルのピーク時テールにより、実際のエンドツーエンド時間は大きく変動します。誤検知のタイムアウトを避けるため、300秒を保守的な基準として設定してください。

拒否されるパラメータを削る

gpt-image-2-all は size, n, quality, aspect_ratio を拒否します — 送信すると検証エラーが発生することがあります。size を通すには、gpt-image-2-vip に切り替えてください。

エラーコードと再試行

Status	意味	推奨
`401`	無効な token	Bearer Token を確認してください
`429`	rate limit / quota 超過	指数バックオフで再試行
`5xx`	一時的な gateway/backend エラー	1〜2回再試行
タイムアウト	リバースチャネルのピーク + 画像のアップロード/ダウンロードのロングテール	クライアントのタイムアウトを ≥ 300s に設定してください（保守的）

クライアントの推奨事項:

リクエストタイムアウトは 300秒から に設定してください（保守的。一般的には 30〜60s ですが、画像のアップロード / ダウンロードとリバースチャネルのピークテールにより変動が大きく、120s では誤タイムアウトが頻発します）
5xx とタイムアウトには 指数バックオフ を使用してください（2〜3回の再試行を推奨）
デバッグのために request-id レスポンスヘッダーをログに記録してください

FAQ

gpt-image-2-all と gpt-image-2-vip の両方がありますが、どちらを選ぶべきですか？

どちらも同じ呼び出し形式を持つリバースエンジニアリングチャネルです。-all は1回あたり $0.025、-vip は1回あたり $0.03 です。違いは size のサポート、生成時間、安定性です：

厳密なサイズ制御が不要で、より高速かつ安定した出力を求める場合 → gpt-image-2-all（約30〜60秒、プロンプト内でサイズを指定、1K〜1.5K出力）。
出力サイズを固定したい、または4Kが必要な場合 → gpt-image-2-vip（約90〜150秒、4Kを含む30種類の明示的なサイズ）。
quality の調整機能や OpenAI API との完全なフィールド互換性が必要な場合 → 公式の gpt-image-2 をご利用ください。

一度に複数の画像を生成できますか？

いいえ。このモデルは1回の呼び出しにつき1枚の画像を返します。N枚の画像が必要な場合は、APIを並行してN回呼び出してください。各呼び出しはそれぞれ $0.025 で個別に課金されます。

n パラメータはサポートされていますか？n=3 を渡すとどうなりますか？

**いいえ。**このモデルは1回の呼び出しにつき1枚の画像を返します。複数の画像が必要な場合は、繰り返しの呼び出しまたは並行呼び出しを使用してください。⚠️ 重要：リクエストで n=3 を渡すと、課金は 0.025 × 3 = $0.075 になりますが、実際に返される画像は1枚のみです。無駄な課金を避けるため、リクエストから n フィールドを必ず削除してください。

コンテンツが拒否されたり、モデルが「I can't do that」と返答した場合、課金されますか？

これは同期的なチャット形式のレスポンスを使用するリバースエンジニアリングチャネルです。結果は課金ルールの異なる2つのケースに分かれます：1) HTTP 5xx が返された場合 → 課金されません上流のコンテンツポリシーによってリクエストがハードブロックされると、次のようなレスポンスが返されます：

{
  "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
  }
}

これらのハードエラーは課金されません。ユーザーにプロンプトを調整して再試行するよう促してください。2) テキストによる「ソフトな拒否」を含む HTTP 200 → 課金されます会話内でモデルがソフトな拒否を行った場合（例：「I can’t do that」、「申し訳ありませんが、このリクエストには…が含まれています」など）、プロトコルレベルでは通常の chat completion として扱われるため、課金されます。リバースチャネルでは、プロトコル層で「拒否テキスト」と「画像出力」を確実に区別することができません。ソフトな拒否を単純に免除できない理由すべてのソフトな拒否を自動的に免除すると、プラットフォームが上流の失敗したすべての呼び出しコストを負担することになります。さらに重要なこととして、上流のコンテンツセーフティを頻繁にトリガーすると、サプライヤーのアカウントが利用停止（BAN）されるリスクも高まります。これは、完全には排除できない供給側の実質的なコストです。インテグレーターへの推奨事項

✅ 事前フィルタリングとユーザーへの警告：フロントエンドまたはゲートウェイでキーワード/シナリオのフィルター（実在の人物名、著作権のあるキャラクター、センシティブなトピック）を追加し、「有名人やIP関連のトピックは失敗する可能性があり、その場合でも上流ポリシーにより課金される場合があります」といったUIヒントを表示します。これにより、無駄な課金を大幅に削減できます。
✅ 消費者向けプロダクト向けの月次返金：一般ユーザー向けプロダクトではユーザー入力を完全に制限できないことを理解しています。月間の利用額が十分に大きい場合（月額 $1000 以上）、ログを月単位でまとめて（レイテンシが短い呼び出しは通常ソフトな拒否に該当します）、サポートにお問い合わせいただくことで、一括の手動クレジット付与を受けることができます。呼び出しごとに異議申し立てを行う必要はありません。

📖 関連：500 エラーは通常コンテンツポリシーの抵触です（課金されません）

b64_json に data:image/png;base64, プレフィックスを追加する必要がありますか？

**まず判定してから処理してください。**2026年7月の検証時点では、返される b64_json は data: プレフィックスのない生の base64 です。ファイルに書き込む場合はデコードし、レンダリングする前にご自身でプレフィックスを先頭に追加してください。なお、以前のバージョンにはプレフィックスが含まれていました。コード内に startsWith('data:') のチェックを追加してください。プレフィックスが存在する場合はその値を直接 img src として使用し、存在しない場合は先にデコードするかプレフィックスを追加します。これにより、二重プレフィックスの付与や、プレフィックス付き文字列をデコードして画像が破損することを防げます。

プロンプトで 1024x1024 と指定しているのに、異なるサイズになるのはなぜですか？

適応型モデルはサイズの記述を「強制」ではなく「ガイダンス」として扱います。指示への追従性を高めるには、サイズや構図に関する単語をプロンプトの先頭に配置し、スタイルの記述子（例：cinematic、phone poster、square composition）と組み合わせてください。特定の解像度に高い信頼性でマッピングされる言い回しについては、このページの前半（「サイズとアスペクト比の制御」内）にある「検証済みのプロンプト表現 → 実際の解像度」テーブルを参照してください。

入力画像を圧縮すべきですか？プロンプトに 4K や 8K と記述すると効果はありますか？

はい、強く推奨します。各入力画像を 1.5MB 未満に圧縮してください（JPEG 品質 80〜90 / 解像度を縮小）。散発的なサーバー側のエラーは過大な入力によって引き起こされることが最も多く、圧縮することで成功率とレイテンシを目に見えて改善できます。注：1.5MB は信頼性と速度のための推奨上限値です。上記の FAQ に記載されている 10MB はゲートウェイのハードリミットです。圧縮による画質の低下を心配する必要はありません。このモデルの出力解像度は入力サイズではなく、プロンプトの構図の言い回しによって決まります。入力を小さくすることは処理速度を向上させるだけです。プロンプトに 4K や 8K を詰め込んでも、実際には高解像度の画像は生成されません。それらの単語は単なる装飾であり、モデルがそれによって解像度を上げることはありません。確実により大きな出力を得るには、上記の「検証済みのプロンプト表現 → 実際の解像度」テーブルにある検証済みの言い回し（例：cinematic、phone poster、square composition）を使用してください。厳密なサイズ固定または 4K が必要な場合は、gpt-image-2-vip（4K を含む 30 種類の明示的なサイズ、一律 $0.03/画像）に切り替えてください。

参照画像の最大サイズとサポートされている形式は何ですか？

推奨は画像1枚あたり 10MB 以下、形式は png / jpg / webp です。過度に大きな画像はゲートウェイの制限に達する可能性があります。複数画像の融合を行う場合、各画像がこの制限を満たす必要があります。

返された画像 URL の有効期限はどのくらいですか？ダウンロードする必要がありますか？

url モードのレスポンスの url フィールドは、約1日（24時間）で期限切れになる R2 CDN リンクです。それ以降のリクエストは 404 になります。強く推奨：生成後すぐに、生成された画像をご自身のオブジェクトストレージ（S3 / OSS / R2）、CDN、またはデータベースにダウンロードして永続化してください。返された URL への長期的な直リンクは避けてください。2つの推奨アプローチ：

サーバーサイドプロキシ：レスポンス受信後すぐに requests.get(url) を行い、ご自身のストレージに保存して、独自の URL をフロントエンドに返します。
b64_json の使用：リクエストに "response_format": "b64_json" を追加して base64 画像データを直接取得します。クロスオリジンのダウンロードが1回減るため、フロントエンドでのレンダリングやファイルへの直接書き込みに最適です。

短時間のプレビュー（単一セッション内での表示）であれば、永続化せずに R2 URL をそのまま使用できます。

ストリーミングはサポートされていますか？

いいえ。このモデルは画像を一度に返します。ストリーミングはサポートされていません。レイテンシが懸念される場合は、クライアント側で「生成中…」のような進行状況インジケーターを表示し、300秒のタイムアウト（保守的な設定）を設定してください。

公式の OpenAI SDK は使用できますか？

はい。base_url を https://api.apiyi.com/v1 に向け、api_key を APIYI の token に設定してください。ただし、client.images.generate() はデフォルトで size / n を送信します。このモデルは両方のパラメータを拒否するため、/v1/images/generations および /v1/images/edits に対して requests / fetch を使用して生の HTTP 呼び出しを行うことを推奨します。

中国語と英語のプロンプトで大きな違いはありますか？

このモデルはネイティブに中国語をサポートしており、結果は同等です。中国語特有のシナリオ（書道、伝統的な祭りの要素など）では、中国語の表現の方がより自然に仕上がります。

/v1/chat/completions 経由で画像を生成することは引き続き可能ですか？

はい、エンドポイントは引き続き動作しますが、現在は推奨されていません。代わりに /v1/images/generations および /v1/images/edits を使用してください（より安定しており、公式リレーの gpt-image-2 とも同じコードで動作します）。チャットベースの形式が適しているのは、マルチターンの反復編集、またはオンライン画像 URL を直接渡す場合の2つのシナリオのみです。画像の生成意図が曖昧な場合、モデルは画像の代わりにプレーンテキストを返す可能性がある点にご注意ください（プロンプトの先頭に「画像を生成してください：」のような固定プレフィックスを追加して強調してください）。完全なパラメータについては、チャットベースの API リファレンスを参照してください。

基本

基本API

画像API（公式）

動画API（公式）

マルチモーダル理解API

テキスト生成

音声API（公式）

検索と安全性

GPT-Image-2.5-All 画像生成/編集

概要

テキスト画像生成 API

画像編集 API

AIエージェントに統合を任せる

主な機能

非常に競争力のある価格設定

高度なテキストレンダリング

中国語プロンプトに対応

複数画像の融合

より高速な出力

R2 CDNによる高速化

自然言語による編集

標準エンドポイントのサポート

料金

グループの設定

確定的なURL出力が必要な場合 → `image2_OSS`グループへの切り替え

技術仕様

エンドポイント

サイズとアスペクト比の制御（prompt 内に記述）

検証済みの「prompt の表現 → 実際の解像度」表

スタイル用の表現（固定解像度なし）

この表をエンドユーザーに公開する

ベストプラクティス

エラーコードと再試行

FAQ

関連ドキュメント

​概要

テキスト画像生成 API

画像編集 API

​AIエージェントに統合を任せる

​主な機能

非常に競争力のある価格設定

高度なテキストレンダリング

中国語プロンプトに対応

複数画像の融合

より高速な出力

R2 CDNによる高速化

自然言語による編集

標準エンドポイントのサポート

​料金

​グループの設定

​確定的なURL出力が必要な場合 → image2_OSSグループへの切り替え

​技術仕様

​エンドポイント

​サイズとアスペクト比の制御（prompt 内に記述）

​検証済みの「prompt の表現 → 実際の解像度」表

​スタイル用の表現（固定解像度なし）

​この表をエンドユーザーに公開する

​ベストプラクティス

​エラーコードと再試行

​FAQ

​関連ドキュメント

概要

AIエージェントに統合を任せる

主な機能

料金

グループの設定

確定的なURL出力が必要な場合 → `image2_OSS`グループへの切り替え

技術仕様

エンドポイント

サイズとアスペクト比の制御（prompt 内に記述）

検証済みの「prompt の表現 → 実際の解像度」表

スタイル用の表現（固定解像度なし）

この表をエンドユーザーに公開する

ベストプラクティス

エラーコードと再試行

FAQ

関連ドキュメント