OpenAI 画像モデル API
gpt-image-2、gpt-image-2.5、az-gpt-image シリーズの画像モデルについて、エンドポイント、サイズ、品質レベル、参照画像、透過背景を説明します。
対象範囲
このページでは OpenAI 画像モデル(gpt-image-* と az-gpt-image-*)の画像エンドポイントを説明します。Gemini 画像モデルは Gemini 画像モデル API、Grok 画像モデルは Grok 画像モデル API をご覧ください。
公式ドキュメント
エンドポイントの選択
OpenAI 画像モデルは画像エンドポイントのみを使用します。/v1/chat/completions や /v1/responses で代用しないでください:
| 用途 | リクエストメソッド | エンドポイント |
|---|---|---|
| テキストから画像生成 | POST | /v1/images/generations |
| 画像編集 | POST | /v1/images/edits |
モデルと機能
| モデル | 解像度 | 参照画像 | 1 回の枚数 | 課金 |
|---|---|---|---|---|
gpt-image-2 | 1K (既定) / 2K / 4Ksize にピクセル | 最大 4 枚 (ローカルファイル) | 常に 1 枚 | 1 枚ごと |
gpt-image-2.5-flare | 1K (既定) / 2K / 4Ksize にピクセル | 最大 10 枚 (ローカルファイル) | 常に 1 枚 | 1 枚ごと |
gpt-image-2.5-sunburst | 1K (既定) / 2K / 4Ksize にピクセル | 最大 10 枚 (ローカルファイル) | 常に 1 枚 | 1 枚ごと |
az-gpt-image-2 | 1K (既定) / 2K / 4Ksize にピクセル | 最大 10 枚 (ローカルファイル / Data URI / 公開 URL) | 最大 10 枚 | トークン単位 |
az-gpt-image-2.5-flare | 1K (既定) / 2K / 4Ksize にピクセル | 最大 10 枚 (ローカルファイル / Data URI / 公開 URL) | 最大 10 枚 | トークン単位 |
az-gpt-image-2.5-sunburst | 1K (既定) / 2K / 4Ksize にピクセル | 最大 10 枚 (ローカルファイル / Data URI / 公開 URL) | 最大 10 枚 | トークン単位 |
対応するアスペクト比:1:1 (既定) / 3:2 / 2:3 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9 / 2:1 / 1:2
| モデル | quality | background | output_format | response_format |
|---|---|---|---|---|
gpt-image-2 | low / medium / high | 非対応 | 非対応 | b64_json / url |
gpt-image-2.5-flare | low / medium / high | 非対応 | 非対応 | b64_json / url |
gpt-image-2.5-sunburst | low / medium / high | 非対応 | 非対応 | b64_json / url |
az-gpt-image-2 | low / medium / high / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-flare | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-sunburst | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
2 つのモデルグループはリクエスト方法は同じで、使えるパラメータと課金方式が異なります:
gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst:枚数課金で、料金はサイズや品質レベルに関係ありません。size、qualityに対応し、1 リクエストにつき 1 枚を返します。az-gpt-image-2、az-gpt-image-2.5-flare、az-gpt-image-2.5-sunburst:透過背景background、出力形式output_format、1 回で複数枚を生成するn(最大 10)、ストリーミングプレビュー、JSON 形式の編集リクエストなど、OpenAI Images のパラメータにすべて対応します。トークン課金で、料金はサイズと品質レベルによって変わります。
実際に利用可能なモデルは、コンソールが返すモデルリストをご確認ください。
認証
すべてのリクエストに 88API のアクセストークンを含める必要があります:
Authorization: Bearer $API_KEY
Content-Type: application/jsonサイズ
size はピクセル単位の 幅x高さ で指定する必要があり、1K、2K、4K のような文字列は受け付けません。有効なサイズは次の条件をすべて満たす必要があります:
- 幅と高さがどちらも 16 の倍数であること
- 長辺が 3840 以下であること
- 長辺と短辺の比が 3:1 以下であること
- 総ピクセル数が 655,360(約 816×816)から 8,294,400(3840×2160)の範囲内であること
各レベルの推奨サイズは次のとおりです(全モデル共通):
| 比率 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 2400x1600 | 3504x2336 |
| 2:3 | 1024x1536 | 1600x2400 | 2336x3504 |
| 4:3 | 1152x864 | 2048x1536 | 3264x2448 |
| 3:4 | 864x1152 | 1536x2048 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1344x576 | 3024x1296 | 3840x1648 |
| 2:1 | 1408x704 | 2880x1440 | 3840x1920 |
| 1:2 | 704x1408 | 1440x2880 | 1920x3840 |
size を省略するか auto を指定すると、モデルがサイズを決定します。上記の条件を満たさないサイズは拒否されるか自動調整されることがあるため、リクエスト前にご自身で確認してください。
テキストから画像生成
リクエスト
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "窓辺に座る茶トラ猫、午後の自然光、写実的な写真スタイル",
"size": "2048x2048",
"quality": "medium"
}'リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | 画像モデル名。例:gpt-image-2。 |
prompt | string | はい | 画像内容の説明。被写体、構図、スタイル、光、アスペクト比を明確に書くことをおすすめします。 |
size | string | いいえ | ピクセルサイズ。ルールは上記「サイズ」を参照してください。 |
quality | string | いいえ | gpt-image-* は low、medium、high に対応。az-gpt-image-2 は low、medium、high、auto に対応し、az-gpt-image-2.5-* はさらに xhigh、max にも対応します。省略時は low で生成します。 |
n | integer | いいえ | 生成枚数。az-gpt-image-* は 1 から 10 まで対応。gpt-image-* は 1 リクエストにつき 1 枚のため、複数枚必要な場合は複数のリクエストを送信してください。 |
response_format | string | いいえ | b64_json(デフォルト)または url。url を指定すると 88API の画像リンクを返します。 |
background | string | いいえ | az-gpt-image-* のみ:transparent、opaque、auto。 |
output_format | string | いいえ | az-gpt-image-* のみ:png(デフォルト)、webp、jpeg。 |
output_compression | integer | いいえ | az-gpt-image-* のみ。0 から 100 で、jpeg、webp にのみ有効です。 |
レスポンス例
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}デフォルトでは data[].b64_json を返します。リクエストで "response_format": "url" を指定すると data[].url を返します。
画像編集
画像編集には /v1/images/edits を使用します。ローカル画像をアップロードする場合は multipart/form-data を使用し、複数の参照画像は image[] を繰り返して渡します。最大 10 枚(gpt-image-2 は最大 4 枚)で、PNG、JPEG、WebP に対応しています。
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=gpt-image-2" \
-F "image[]=@person.png" \
-F "image[]=@product.png" \
-F "prompt=1 枚目の人物に 2 枚目の製品を持たせる。人物と製品の見た目は変えない" \
-F "size=1536x1024"参照画像にはアップロード順に番号が付くため、プロンプトでは「1 枚目」「2 枚目」のように指定できます。
JSON 編集リクエスト(az-gpt-image-* のみ)
az-gpt-image-* は JSON 形式の編集リクエストにも対応しており、参照画像には Data URI または公開 URL を使用できます:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2.5-flare",
"prompt": "背景を水色の撮影スタジオに置き換える",
"images": [
{ "image_url": "data:image/png;base64,..." },
{ "image_url": "https://example.com/reference.png" }
],
"size": "1024x1024"
}'gpt-image-* では multipart でアップロードしてください。
透過背景(az-gpt-image-* のみ)
背景が透明なステッカー、アイコン、切り抜き画像が必要な場合は、background を transparent に設定し、png または webp で出力します:
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2",
"prompt": "「がんばれ」の札を掲げたパンダのステッカー、すっきりした縁取り",
"size": "1024x1024",
"background": "transparent",
"output_format": "png"
}'jpegは透過に対応していないため、transparentと組み合わせると不透明な画像が返されます。- 編集時に
transparentを指定すると背景を除去できます。参照画像自体が透過している場合は、出力でも透過が保持されます。 opaqueでも不透明になるとは限りません。プロンプトで「ステッカー」「背景なし」などを明示すると、透過画像が返されることがあります。
ストリーミングプレビュー(az-gpt-image-* のみ)
"stream": true と "partial_images": 1 から 3 を設定すると、SSE で途中経過のプレビュー image_generation.partial_image が返され、最後のイベント image_generation.completed に最終画像と使用量が含まれます。編集リクエストのイベント名は image_edit.* です。
課金について
gpt-image-*は正常に返された枚数で課金され、サイズや品質レベルには関係ありません。az-gpt-image-*はトークン課金です。テキスト入力、画像入力(参照画像)、画像出力がそれぞれ別に計算されます。出力トークンはサイズと品質レベルのみで決まり、レベルが高いほど料金も高くなります。az-gpt-image-2.5-*は同じ名前のレベルでもaz-gpt-image-2よりトークンが少なくなります(2.5 のhighは 2 のmediumとほぼ同等)。- 失敗したリクエストは課金されません。
重要な制限事項
- これらのモデルのリクエストを
/v1/responsesや/v1/chat/completionsに送信しないでください。 maskによる部分的な再描画には対応していません。マスクを渡しても領域ごとの再描画は行われないため、部分的に変更したい場合はプロンプトで位置を説明してください。input_fidelityパラメータには対応していません。- GIF を参照画像として使うことはおすすめしません。先に PNG に変換してください。
- 高品質レベルや 4K サイズでは 1〜2 分かかることがあり、
az-gpt-image-2.5-*のmaxレベルでは最大で約 2 分半かかります。クライアントのタイムアウトは 5 分以上に設定することをおすすめします。 Invalid size ...が返された場合は、上記「サイズ」のルールに沿ってsizeを確認してください。This model does not support image generation.またはimage_model_wrong_endpointが返された場合は、リクエストの送信先エンドポイントが間違っています。