Runbase

Command Palette

Search for a command to run...

OpenAI

GPT Image 2.5

ID:openai/gpt-image-2.5

OpenAI の GPT Image 2.5 画像生成 API — Flare と Sunburst の 2 バージョン、4K 出力、13 種のアスペクト比、参照画像による編集に対応。

GPT Image 2.5ChatGPT Images 2.5OpenAI画像編集インペインティング

概要

OpenAI の GPT Image 2.5 画像生成 API — Flare と Sunburst の 2 バージョン、4K 出力、13 種のアスペクト比、参照画像による編集に対応。

認証

すべての API リクエストには、Authorization ヘッダーで Bearer スキームを使用した有効な API キーが必要です。

クイックスタート

認証情報

環境変数 RUNBASE_API_KEY を設定してください。

Shell
export RUNBASE_API_KEY=your-api-key

実行を作成

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

実行

実行は非同期で処理されます。リクエストを送信し、結果をポーリングで取得してください。

実行を作成

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

実行ステータスを取得

Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

結果を取得

status が "succeeded" になるまでステータスエンドポイントをポーリングし、レスポンスの output.urls を参照してください。

入力スキーマ

パラメータタイプ必須説明
promptstring必須Prompt
variantstring任意Versionオプション: flaresunburst
aspect_ratiostring任意Aspect ratioオプション: auto1:13:22:316:99:164:33:421:927:1616:279:88:9
resolutionstring任意Resolutionオプション: 1K2K4K
image_urlsstring[]任意Reference images

出力スキーマ

フィールドタイプ説明
urlsstring[]生成された出力 URL

エラー

API は標準の HTTP ステータスコードで成功または失敗を示します。

ステータスコード説明
400無効なリクエスト - パラメータが不足または不正
401認証エラー - API キーが不足または無効
402クレジット不足
403アクセス拒否 - IP が許可されていないか、API キーの利用上限を超過
404実行が見つかりません
429レート制限を超過
500内部サーバーエラー