GPT Image 2.5 画像 API

ReachAPI は GPT Image 2.5 Flare と Sunburst を、OpenAI 互換の同期 Image API と ReachAPI の非同期タスク API の両方で提供します。両製品は現在 Internal Preview です。

• gpt-image-2.5-flare: 高速で高品質な日常画像生成向け。
• gpt-image-2.5-sunburst: 最高性能と編集精度を重視するワークフロー向け。

1. インターフェースの選択

• 同期生成: POST https://direct.reachapi.ai/v1/images/generations
• 同期編集: POST https://direct.reachapi.ai/v1/images/edits
• 非同期タスク: POST https://direct.reachapi.ai/v1/images/create
• 非同期タスク照会: GET https://direct.reachapi.ai/v1/tasks/{task_id}

呼び出し元が完了レスポンスを待つことができ、OpenAI ネイティブのリクエスト・レスポンス形式を使いたい場合は、同期 Image API を使用します。長時間のジョブ、URL 形式の参照画像、ポーリング、コールバック、data[].url のホスト済み結果が必要な場合は、非同期タスク API を使用します。

どちらも同じモデルコードと認証方式を使用します。

Authorization: Bearer YOUR_REACH_API_KEY

2. 同期 Image API

同期エンドポイントは OpenAI Image API の契約に従います。画像生成は JSON、画像編集は 1 個以上の画像ファイルを含むネイティブ multipart フォームを使用します。

画像を生成する

curl -X POST "https://direct.reachapi.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_REACH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A precise editorial product photograph of a silver watch on slate, soft studio lighting",
    "size": "1536x1024",
    "quality": "high",
    "background": "auto",
    "moderation": "auto",
    "output_format": "png"
  }'

画像を編集する

curl -X POST "https://direct.reachapi.ai/v1/images/edits" \
  -H "Authorization: Bearer YOUR_REACH_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "prompt=Preserve the watch geometry and replace only the background with dark brushed metal" \
  -F "image[]=@/path/to/watch.png" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "output_format=png"

multipart boundary は手動で設定しないでください。クライアント、SDK、または curl -F が自動生成します。

同期 API の契約

• model、prompt、size、quality、background、moderation、output_format などの OpenAI 形式のフラットなフィールドを使用し、input で囲まないでください。
• テキストからの画像生成には POST /v1/images/generations、ファイルベースの画像編集には POST /v1/images/edits を使用します。
• 同期エンドポイントは OpenAI ネイティブの Images レスポンスを返します。ReachAPI の task_id は返さず、タスクポーリングや callback_url にも対応しません。
• マスク、複数画像編集、完全なパラメーターとレスポンスの契約は、OpenAI 互換エンドポイントに従います。

3. 非同期タスク API

非同期エンドポイントは { "model": "...", "input": { ... } } というネスト構造のリクエストを使用し、すぐにタスク ID を返します。

curl -X POST "https://direct.reachapi.ai/v1/images/create" \
  -H "Authorization: Bearer YOUR_REACH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "callback_url": "https://example.com/reachapi/callback",
    "input": {
      "prompt": "A precise editorial product photograph of a silver watch on slate, soft studio lighting",
      "resolution": "2k",
      "aspect_ratio": "3:2",
      "quality": "high",
      "background": "auto",
      "moderation": "auto",
      "output_format": "png"
    }
  }'

トップレベルパラメーター

input パラメーター

background=transparent と output_format=jpeg は同時に使用できません。

標準サイズの対応

必要な組み合わせが表にない場合は input.size を使用してください。

非同期画像編集

input.image_urls を指定すると参照画像を編集・変換できます。

{
  "model": "gpt-image-2.5-sunburst",
  "input": {
    "prompt": "Preserve the watch geometry and replace only the background with dark brushed metal",
    "image_urls": ["https://cdn.example.com/watch.png"],
    "resolution": "2k",
    "aspect_ratio": "3:2",
    "quality": "xhigh",
    "output_format": "png"
  }
}

タスク結果とコールバック

送信に成功するとタスク ID が返ります。

{
  "code": 200,
  "msg": "",
  "status": "queued",
  "task_id": "task_xxx",
  "data": []
}

状態が success または failed になるまで GET /v1/tasks/{task_id} をポーリングします。成功時は data[].url に画像が入り、size と revised_prompt が含まれる場合もあります。

callback_url を指定すると、ReachAPI は完了状態のレスポンスをその HTTPS URL に送信します。1 回のタイムアウトは 10 秒で、初回失敗後に最大 2 回再試行します。

非同期 API の制約

• prompt は必須で、空にはできません。
• image_urls は HTTPS URL を最大 14 件受け付けます。base64 画像入力には対応しません。
• この非同期 API では n > 1、mask、output_compression、user を公開しません。
• size を省略する場合、resolution + aspect_ratio は標準対応表に含まれる必要があります。

4. 料金

同期と非同期は同じ GPT Image 2.5 Standard トークン料金を使用します。ReachAPI の課金対象は次の 3 項目のみです。

Flare と Sunburst のトークン単価は同一です。モデル、品質、サイズ、プロンプト、参照画像によってトークン使用量が変わるため、画像 1 枚あたりの実際の料金も変動します。

5. 提供状況と公式リファレンス

2 つの GPT Image 2.5 モデルコードは Internal Preview のため、GET /v1/models に表示されない場合があります。

• OpenAI 画像生成ガイド
• OpenAI Images API リファレンス
• OpenAI 料金