OWN NEWS GATHER
← 戻る
OpenRouter Blog

OpenRouter、複数事業者の画像生成AIを共通規格で利用できる統合APIを発表

要点

  • OpenRouterは、多様なAI事業者の画像生成モデルを単一のエンドポイントと共通APIキーで利用可能にする「Image generation API」の技術解説を公開した。

  • 従来は提供元ごとに異なっていたリクエスト構造や制御パラメータ、課金体系の差異を吸収し、POST /api/v1/images への通信に一本化される。

  • 生成された画像はホスティングURLではなくBase64形式（data[0].b64_json）で返却され、ローカル環境へ直接デコードして保存できる。

  • 画像生成対応モデルの仕様や価格情報を動的に取得する専用エンドポイント（GET /api/v1/images/models）や、参照画像入力（input_references）にも対応する。

  • AIモデルのルーティングプラットフォームを運営するOpenRouterは現地時間2026年8月17日、異なる事業者の画像生成モデルを統一されたインターフェースで呼び出せる「Image generation API」のチュートリアルを公開した。開発者は単一のアカウントとAPIキーを用い、ByteDanceなどのモデルをはじめとする複数プロバイダーの画像生成機能を同一のコード体系で扱えるようになる。従来の事業者ごとに分断されていたデータフォーマットや認証手順を一本化することで、開発における統合負担を軽減することが狙いだという。

複数プロバイダーの統合に伴う開発負荷を軽減

複数のAIプロバイダーが提供する画像生成機能をアプリケーションへ組み込む場合、事業者ごとに接続先のエンドポイント（APIにアクセスするためのネットワーク上の接続先URL）やリクエストのデータ構造、利用可能な制御パラメータが異なっている。さらに、課金体系についても画像1枚単位、メガピクセル（画像の解像度を表す画素数単位）単位、あるいはトークン単位など事業者ごとに基準が分かれており、複数モデルの併用や切り替えを行う開発者にとって大きな障壁となっていた。

OpenRouterはこうした統合上の課題に対し、単一のリクエスト形式と共通のAPIキーのみで完結する画像生成APIを用意したと説明している。これにより、モデル名の文字列を変更するだけで、異なる事業者が提供する画像生成モデルへ柔軟にリクエストを送信できるようになる。

単一エンドポイントへのシンプルなJSONリクエスト

今回解説されたAPIの基本仕様では、https://openrouter.ai/api/v1/images に対してHTTP POSTリクエストを送信する形をとる。認証にはOpenRouterの管理画面で発行したAPIキーをBearerトークンとしてヘッダーに指定する。

リクエストのJSONボディで必須となるフィールドは2点のみで、利用する画像モデルを指定する model と、生成したい画像の内容をテキストで記述する prompt を指定する。チュートリアルの初期実装例としては、ByteDanceが提供するモデル「bytedance-seed/seedream-4.5」が採用されている。

Base64形式による直接返却とファイル保存の流れ

画像生成リクエストが正常に処理された場合、サーバーからはバッファ形式のレスポンスが返却される。生成された画像データは外部サーバーのURLリンクではなく、Base64（バイナリデータを英数字の文字列として表現するエンコード方式）の文字列としてレスポンス内の data[0].b64_json フィールドに格納される仕様となっている。

レスポンスのデータ構造には、出力された画像形式を判別可能な場合に付与される media_type（PNGやJPEG、WebPなどモデルに応じた形式）や、実行にかかった費用を示す usage.cost フィールド（取得可能な場合のみ）が含まれる。また、1回のリクエストで複数の画像結果を受け取れるよう、data フィールド自体は配列形式で設計されている。

チュートリアルではPythonおよびJavaScript（Node.js）を用いた具体的な実装コードが提示されており、受け取ったBase64文字列をバイナリデータへデコードし、ローカルディスクへ画像ファイルとして直接書き出して保存する手順が解説されている。

モデル探索用エンドポイントと参照画像の入力サポート

OpenRouterの画像生成APIでは、利用可能なモデルの仕様をプログラム上から動的に把握するための仕組みも提供される。GET /api/v1/images/models エンドポイントへアクセスすることで、画像生成に対応したモデルのスラグ（識別子）や、各モデルがサポートしているパラメータの一覧をランタイムで取得できるという。さらに、各モデルのエンドポイント情報を通じて、プロバイダー固有の機能や価格設定を確認することも可能とされている。

また、解像度指定や複数枚出力といったオプション機能に加え、対応しているモデルであれば input_references パラメータ経由で参照画像を送信し、指定した画像をベースにしたバリエーション生成を行う機能もサポートされる。

補足

OpenRouterはこれまでテキスト生成AIのマルチモデル統合環境を提供してきたが、本機能によって画像生成分野においても単一のAPI規格を通じた柔軟なモデル選定が可能になる。

元URL