Model and Modality Playbooks2026年6月22日Big Y

Flatkey 経由の GPT Image 2 API: 料金、モデル、リクエストチェック

本 GPT Image 2 API ガイドを使って、本番トラフィックの前に Flatkey のモデル行、料金単位、エンドポイント対応、リクエストチェックを確認してください。

GPT Image 2 API への Flatkey 経由のアクセスは、コピーしたコードブロックではなく、まずモデル行の確認から始めるべきです。OpenAI は gpt-image-2 を現在の画像生成モデルとして記載しており、Flatkey の 2026年6月17日の料金スナップショットには GPT 画像ファミリーの行が掲載されています。本番チームにとって有用な問いは、より限定的です。アプリはどの行を呼び出すのか、その行はどのエンドポイント形状を公開するのか、財務レビューで確認すべき料金単位は何か、そしてルーターを通る前にどのリクエストチェックが通過すべきなのか、という点です。

このガイドでは、1つの Flatkey キー、OpenAI 互換のベース URL https://router.flatkey.ai/v1、利用ログ、料金レビューを一か所で扱いたいチーム向けに、これらの確認事項を順に説明します。以下のコードサンプルはすべてテンプレートとして扱ってください。この記事では、公式 OpenAI ドキュメント、日付付きの Flatkey カタログスナップショット、CMS/公開ルートの確認を使用していますが、実際の Flatkey GPT Image 2 API の推論テストが実行されたとは主張しません。

GPT Image 2 API を Flatkey 経由で使用する前に確認すべきこと: クイック回答

GPT Image 2 API を Flatkey で評価している場合は、次の順序で確認してください。

Flatkey の料金ページを開き、gpt-image-2 や openai/gpt-image-2 のような正確なモデル行を検索します。
その行でサポートされているエンドポイント種別を確認します。2026年6月17日のスナップショットでは、主要な gpt-image-2 の行は openai を公開していましたが、古い GPT image の行では image-generation も公開されていました。
利用可否ステータスを確認します。スナップショット内の GPT Image 2 の行は unknown_failure を示していたため、本番利用には最新のダッシュボード確認と小さなスモークテストが必要です。
リリース前に料金単位を比較します。Flatkey では、ある行に対してはトークン比率形式のフィールドが表示され、別の行ではリクエスト課金のように見える model_price フィールドが表示されていたため、すべての GPT Image 2 API ルートで同じ単位だと決めつけないでください。
確認したルートにリクエスト本文を合わせます。Images API 形式、Responses API 形式、または Flatkey がサポートする OpenAI 互換ラッパーのいずれかです。
モデル ID、エンドポイントパス、品質、出力サイズ、出力形式、入力画像数、リトライ回数、使用量、承認されたアセットごとの最終コストを記録します。

この順序が重要なのは、GPT Image 2 API が単なるモデル名ではないからです。モデル ID、エンドポイント、リクエストパラメータ、アカウントの利用権、ルーティング状態、課金単位の組み合わせだからです。

GPT Image 2 API について OpenAI が文書化している内容

OpenAI の画像ガイドでは、GPT Image モデルはテキスト入力と画像入力を使って新しい画像を作成したり既存の画像を編集したりできると説明されており、gpt-image-2 は指示追従性と文脈認識に優れた最先端の画像生成モデルとして記載されています。また、このガイドでは、チームは Images API または Responses API のいずれかを使って画像を生成または編集できるとも説明しています。

Images API の経路については、create-image のリファレンスで POST /images/generations が文書化されています。そこには、本番のリクエスト確認で重要となるパラメータとして prompt、background、moderation、output_format、quality、size、stream、n が含まれています。また、GPT image モデルは一時的な画像 URL ではなく、base64 エンコードされた画像を返すとも記載されています。

OpenAI の確認項目	Flatkey にとって重要な理由	本番での対応
`model`	OpenAI の直接のモデル ID は、ルーティングされたカタログ行と同じ文字列でない場合があります。	リクエスト内の正確な Flatkey の行とモデル文字列を記録してください。
`POST /images/generations`	これは公式の Images API の生成経路ですが、Flatkey のエンドポイント対応は行ごとに異なります。	選択した行で Images API のサポートがダッシュボードに表示されてから、このルートを Flatkey 経由で使用してください。
`background` and `output_format`	透過出力には、PNG や WebP のような互換フォーマットが必要です。	alpha に依存するデザインワークフローを作成する前に、出力形式を検証してください。
`quality` and `size`	これらは GPT Image 2 API ワークロードにおける主要なコストおよびレイテンシの調整要素です。	ドラフト、プレビュー、最終レンダーの設定を製品ロジックで分けてください。
Base64 response handling	GPT image モデルは、長期間有効なホスト型 URL ではなく画像バイトを返します。	画像を自前で保存し、メタデータを付与し、プロバイダーの URL に依存しないでください。

Flatkey GPT のカタログスナップショット画像 2

2026年6月17日、Flatkey の公開価格APIは価格バージョン a42d372ccf0b5dd13ecf71203521f9d2 と 638 件のモデル行を返しました。GPT 画像ファミリーのサマリーには gpt-image-2、openai/gpt-image-2、gpt-image-2-all、gpt-image-1.5、gpt-image-1-mini、および gpt-image-1 が含まれていました。

Flatkey Row	Groups	Endpoint Types In Snapshot	Pricing Fields Seen	Status In Snapshot	How To Use This Evidence
`gpt-image-2`	Economy, Standard	`openai`	`model_ratio: 3.325`, `completion_ratio: 6`, `cache_ratio: 0.251127819549`	`unknown_failure`	日付付きのカタログ証拠としてのみ使用してください。実運用の GPT Image 2 API トラフィックの前に、現在の行ステータスを確認してください。
`openai/gpt-image-2`	Standard	`openai`	`quota_type: 1`, `model_price: 0.063`	`unknown_failure`	現在の単位とダッシュボードのラベルを確認せずに、この数値をそのまま使わないでください。
`gpt-image-2-all`	Standard	`openai`	`model_ratio: 37.5`, `completion_ratio: 2`	`unknown_failure`	コードで使う前に、これがバンドル、エイリアス、または内部ルーティングの行のどれかを確認してください。
`gpt-image-1.5` and `gpt-image-1-mini`	Standard	`image-generation`, `openai`	Ratio-style pricing fields	`unknown_failure`	比較用としては有用ですが、選択した GPT Image 2 API 行の代わりにはなりません。

公開価格ページでは、/v1/images/generations のパスを持つ image-generation、/v1/chat/completions のパスを持つ openai、および /v1/responses のパスを持つ openai-response などのエンドポイントファミリーも公開されています。重要なのは、エンドポイントファミリーはプラットフォームレベルで存在する一方で、サポートは依然として行ごとに異なるという点です。GPT Image 2 API については、リクエストを書く前に行を確認してください。

GPT Image 2 API のリクエストチェック

ルーティングされたGPT Image 2 APIの展開前に、このチェックリストを使用してください。価格の誤りは、単一の見出しレートの誤解よりも、リクエストの形状に起因することが多いため、あえて運用寄りにしています。

チェック項目	合格条件	失敗パターン	確認箇所
モデル行	Flatkeyダッシュボードの行が、コード内のモデル文字列と一致している。	アプリが誤ってレガシー、エイリアス、またはバンドルの行を呼び出す。	Flatkeyの料金表とモデルカタログ。
エンドポイントパス	ルートパスが、その行でサポートされているエンドポイント種別と一致している。	Images APIの本文がchat互換の行に送信される、またはその逆。	Flatkeyの行サポートとOpenAI APIリファレンス。
可用性	ダッシュボードのステータスが正常で、少量のリクエストが成功する。	カタログ上に行は存在するが、上流またはアカウントアクセスが失敗する。	Flatkeyダッシュボード、レスポンスステータス、ログ。
料金単位	財務部門が、その行がトークン比率課金なのか、リクエスト課金なのか、あるいは別の単位なのかを把握している。	予算が、リクエスト課金の行に対してトークン単価前提で組まれている。	Flatkeyの料金と利用状況ダッシュボード。
プロンプトと画像入力	プロンプト長、画像参照、マスク、再試行がログに記録されている。	入力画像と再試行により、見えないコストが発生する。	アプリケーションのテレメトリとプロバイダーの利用フィールド。
出力設定	品質、サイズ、背景、形式、圧縮が制御されている。	すべてのプレビューが最終成果物として生成される。	リクエスト本文と製品デフォルト。

テンプレート: OpenAI Images API への直接リクエスト

直接プロバイダのテンプレートは、Flatkey のルート動作と比較する際のベースラインとして有用です。実行する前に、現在の OpenAI アカウントアクセスとモデルの利用可否を確認してください。

# Template only: direct OpenAI Images API baseline
curl https://api.openai.com/v1/images/generations \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Create a clean product concept image for a usage dashboard.",
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "png"
  }'

ベースラインの GPT Image 2 API テストでは、最初のプロンプトをシンプルに保ち、参照画像を使わず、出力は 1 つにし、レスポンスのステータス、レイテンシー、出力サイズ、およびエンドポイントから返される使用量フィールドを記録してください。

テンプレート: Flatkey ルート確認

Flatkey の公開上の位置づけは、1つのキーと OpenAI 互換のベース URL を中心にしています。テキストルートについては、公開ホームページに https://router.flatkey.ai/v1/chat/completions が表示されています。GPT Image 2 API のルーティングでは、選択した行で画像パスが有効になっていると決めつけないでください。まず、その行がダッシュボードで image-generation、openai、openai-response、または別のルートを公開しているかを確認してください。

# テンプレートのみ: Flatkey の行で image-generation 対応が確認できた場合にのみ、この形を使用してください
curl https://router.flatkey.ai/v1/images/generations \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "使用状況ダッシュボード向けの、クリーンな製品コンセプト画像を作成してください。",
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "png"
  }'

// テンプレートのみ: ベース URL を中央で管理し、確認済みのパスを注入します。
const FLATKEY_BASE_URL = "https://router.flatkey.ai/v1";

async function createImageThroughConfirmedRoute({ path, apiKey, body }) {
  const response = await fetch(`${FLATKEY_BASE_URL}${path}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(body)
  });

  if (!response.ok) {
    throw new Error(`Flatkey route check failed: ${response.status}`);
  }

  return response.json();
}

// ダッシュボードで確認後の例のみ:
await createImageThroughConfirmedRoute({
  path: "/images/generations",
  apiKey: process.env.FLATKEY_API_KEY,
  body: {
    model: "gpt-image-2",
    prompt: "使用状況ダッシュボード向けの、クリーンな製品コンセプト画像を作成してください。",
    size: "1536x1024",
    quality: "medium",
    output_format: "png"
  }
});

現在の Flatkey 行が依然として openai のみを公開している場合は、その GPT Image 2 API 行でサポートされるリクエスト形式を、出荷前にプロダクトまたはサポートに確認してください。カタログ行とエンドポイントパスの両方が必要で、どちらか一方だけでは本番統合にはなりません。

Flatkey で実行する料金チェック

この記事では、最も安全な料金の案内は手順ベースです。Flatkey の料金の現在の行を確認し、OpenAI の現在の画像料金ページと比較し、最後にログで実際のルーティング済み使用量を確認してください。6月17日の Flatkey スナップショットは、カタログに GPT の画像行が存在していたことを示していますが、その行のフィールドは異なる料金表現を使っていました。これで料金レビューのワークフローを構築するには十分ですが、恒久的な価格を断定して公開するには不十分です。

料金に関する質問	記録する内容	重要な理由
どの行が選択されているか？	正確なモデル名、グループ、クォータ種別、エンドポイント種別。	同じカタログ内に複数の GPT 画像ファミリー行が表示されることがある。
表示されている単位は何か？	トークン比率、リクエスト価格、出力単位ごとの価格、またはダッシュボード固有のラベル。	単位を混同すると、モデル名が正しくても予算エラーが発生する。
どの設定でコストが変わるか？	品質、サイズ、プロンプト長、画像入力、出力形式、再試行、バッチ動作。	同じ GPT Image 2 API 機能でも、プレビューと最終レンダーでコスト階層が異なる場合がある。
Flatkey は何をログに記録するか？	リクエスト数、ステータス、使用量、コスト、モデル行、失敗理由。	ログは、ルーティングされた使用量が見積もりと一致しているかを証明する。

画像予算を比較しているチームは、OpenAI Image API Pricing と AI Model Pricing Comparison も読むべきです。これらの記事では、より広範なトークン、画像、動画のコストメカニズムを扱っています。このページでは、Flatkey 固有の GPT Image 2 API ルートチェックに焦点を当てています。

本番トラフィック前のスモークテスト計画

ダッシュボードの行、エンドポイント、価格ユニットが確認された後に、小規模な検証シーケンスを実行します:

チームが OpenAI に直接アクセスできる場合は、OpenAI のベースライン要求を 1 件送信します。
確認済みのエンドポイントとモデル行を通じて、Flatkey の要求を 1 件送信します。
レスポンスの形状、出力形式、出力バイト数、失敗メッセージ、レイテンシーを比較します。
Flatkey の使用ログで、モデル行、リクエスト数、使用量、コストを確認します。
品質、サイズ、背景、出力形式、入力画像を含む、正確な本番設定で繰り返します。
機能をユーザーに公開する前に、再試行上限と停止条件を設定します。
以前の画像ワークフローまたはプロバイダーへの直接ルートに戻せるロールバック手順を保持します。

これは、OpenAI 互換 API 移行ガイドで説明されているのと同じ運用上の дисциплинаです: ルートを意図的に変更し、モデル ID をマッピングし、小さなスモークテストを実行し、スケール前にログを活用します。

Flatkey が GPT Image 2 API に最適な場合

Flatkey は、画像機能がより広範なマルチモーダルスタックの一部である場合に適しています。たとえば、プロンプトの書き換えにテキストモデル、アセット作成に GPT image モデル、レビューにビジョン対応モデル、そしてフォールバックやコスト制御のために他のプロバイダーを使うことができます。1 つのキー、1 つの料金体系、1 つの利用ダッシュボードにより、個別のプロバイダーアカウントを使う場合よりも、そのワークフローを監査しやすくなります。

ただし、Flatkey はプロバイダーレベルの確認を省略する理由にはなりません。GPT Image 2 API では、本番トラフィックの前に、行のステータス、エンドポイントのサポート、リクエストボディが一致している必要があります。6 月 17 日のスナップショットでは、カタログ上の存在は確認できましたが、クリーンな利用可能結果ではありませんでした。

Final GPT Image 2 API チェックリスト

Flatkey の pricing で primary model row を選択済み。
選択した row で endpoint support を確認済み。
Pricing unit と現在の dashboard label を確認済み。
production request shape で small Flatkey route test を完了済み。
Usage logs で row、status、tokens または request units、cost を確認済み。
Retry limits、quota limits、rollout guardrails を設定済み。
Rollback route を文書化済み。

GPT Image 2 API を Flatkey 経由で導入する最も安全な方法は、model access、endpoint support、pricing を 1 つの validation loop として扱うことです。実際の image traffic を移す前に View Pricing で現在の Flatkey GPT image rows を確認してください。