88API88API
使用ガイドAIアプリケーションAPIリファレンスヘルプとサポート
画像(Image)

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-21K (既定) / 2K / 4K
size にピクセル
最大 4 枚 (ローカルファイル)常に 1 枚1 枚ごと
gpt-image-2.5-flare1K (既定) / 2K / 4K
size にピクセル
最大 10 枚 (ローカルファイル)常に 1 枚1 枚ごと
gpt-image-2.5-sunburst1K (既定) / 2K / 4K
size にピクセル
最大 10 枚 (ローカルファイル)常に 1 枚1 枚ごと
az-gpt-image-21K (既定) / 2K / 4K
size にピクセル
最大 10 枚 (ローカルファイル / Data URI / 公開 URL)最大 10 枚トークン単位
az-gpt-image-2.5-flare1K (既定) / 2K / 4K
size にピクセル
最大 10 枚 (ローカルファイル / Data URI / 公開 URL)最大 10 枚トークン単位
az-gpt-image-2.5-sunburst1K (既定) / 2K / 4K
size にピクセル
最大 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

モデルqualitybackgroundoutput_formatresponse_format
gpt-image-2low / medium / high非対応非対応b64_json / url
gpt-image-2.5-flarelow / medium / high非対応非対応b64_json / url
gpt-image-2.5-sunburstlow / medium / high非対応非対応b64_json / url
az-gpt-image-2low / medium / high / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-flarelow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-sunburstlow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_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)の範囲内であること

各レベルの推奨サイズは次のとおりです(全モデル共通):

比率1K2K4K
1:11024x10242048x20482880x2880
3:21536x10242400x16003504x2336
2:31024x15361600x24002336x3504
4:31152x8642048x15363264x2448
3:4864x11521536x20482448x3264
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
21:91344x5763024x12963840x1648
2:11408x7042880x14403840x1920
1:2704x14081440x28801920x3840

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

リクエストパラメータ

パラメータ型必須説明
modelstringはい画像モデル名。例:gpt-image-2。
promptstringはい画像内容の説明。被写体、構図、スタイル、光、アスペクト比を明確に書くことをおすすめします。
sizestringいいえピクセルサイズ。ルールは上記「サイズ」を参照してください。
qualitystringいいえgpt-image-* は low、medium、high に対応。az-gpt-image-2 は low、medium、high、auto に対応し、az-gpt-image-2.5-* はさらに xhigh、max にも対応します。省略時は low で生成します。
nintegerいいえ生成枚数。az-gpt-image-* は 1 から 10 まで対応。gpt-image-* は 1 リクエストにつき 1 枚のため、複数枚必要な場合は複数のリクエストを送信してください。
response_formatstringいいえb64_json(デフォルト)または url。url を指定すると 88API の画像リンクを返します。
backgroundstringいいえaz-gpt-image-* のみ:transparent、opaque、auto。
output_formatstringいいえaz-gpt-image-* のみ:png(デフォルト)、webp、jpeg。
output_compressionintegerいいえ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 が返された場合は、リクエストの送信先エンドポイントが間違っています。