OpenAI Image API

このプラットフォームでは、OpenAI Image API 互換の画像インターフェースを提供しており、現在の推奨モデルは gpt-image-2 です。

2026-04-28 時点で、OpenAI の公式モデルページでは gpt-image-2 が既定の最上位画像生成モデルとして案内されています。ReachAPI 側では、リクエストとレスポンスの構造は OpenAI ネイティブ API と同じで、主な差分はベースドメインの置き換えだけです。

タスク照会、完了時コールバック、data[].url での最終画像 URL 取得が必要な場合は、GPT Image 2 非同期画像 API で model: "gpt-image-2-async" を使用してください。

エンドポイント対応表

認証

ReachAPI キーを使用します。

Authorization: Bearer YOUR_REACH_API_KEY

画像生成リクエストでは、あわせて以下も送信します。

Content-Type: application/json

画像編集リクエストは OpenAI ネイティブの multipart/form-data をそのまま使います。curl -F や SDK/FormData を使い、Content-Type の boundary を手書きしないでください。

互換メモ

• 推奨モデル: gpt-image-2
• リクエスト項目とレスポンスオブジェクトは OpenAI 公式 Image API ドキュメントに従います
• POST /v1/images/edits は OpenAI ネイティブの画像編集リクエスト形式を使用し、Content-Type は multipart/form-data です
• 編集リクエストのフィールド名は image、mask、prompt、model など公式名をそのまま使います
• 公式の gpt-image-2 モデルページでは、画像生成と画像編集に対応し、ストリーミング非対応と案内されています

最小サンプル

画像生成

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",
    "prompt": "A clean editorial product shot of a cobalt blue mechanical keyboard on a slate desk"
  }'

画像編集

curl -X POST "https://direct.reachapi.ai/v1/images/edits" \
  -H "Authorization: Bearer YOUR_REACH_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Replace the background with a clean studio backdrop and improve the lighting" \
  -F "image=@/path/to/source.png"

公式ドキュメント

• モデルページ: GPT Image 2
• ガイド: Image generation
• API リファレンス: Create image
• API リファレンス: Create image edit

background、moderation、output_format、output_compression、size、quality、mask、input_fidelity などの詳細パラメータと完全なレスポンス項目は、上記の OpenAI 公式ドキュメントを参照してください。画像編集は公式ネイティブの multipart/form-data 形を使ってください。