Max Router を使い始める
モデルを選び、API キーを作成して、Max Router に最初のリクエストを送ります。

モデルとエンドポイントを選ぶ
モデル一覧で利用可能なモデル、対応エンドポイント、現在の料金を比較します。アプリの入出力に合うモデルを選び、正確なモデル ID を控えます。
接続に失敗したときは、どの段階で問題が起きたか分かりにくいものです。まず会話用エンドポイントに対応するモデルを選び、短い質問を一つ送ります。画像、ツール、ストリーミング、複雑な指示は後から追加します。小さなリクエストなら、アドレス、キー、モデル ID、形式を一つずつ確認できます。
一覧で正確なモデル ID、対応エンドポイント、現在の料金を確認します。画面の表示名とコードで必要な識別子は異なることがあるため、記号やバージョンを推測しないでください。テキスト用のエンドポイントが画像や動画にも使えるとは限りません。モデル変更後は必要な機能とパラメータを再確認します。
API キーを作成する
サインインして API キー画面からキーを作成し、環境変数またはシークレット管理サービスに保存します。ブラウザーのコードや公開リポジトリには含めないでください。
環境ごとに別の認証情報を使うと、利用範囲の管理や調査がしやすくなります。キーはサーバー側の環境変数か秘密情報管理から読み込みます。フロントエンドの成果物、ブラウザー拡張、公開リポジトリは秘密の保管場所ではありません。画像やログに漏れたキーは交換し、使用状況を確認します。
アプリからゲートウェイを通じてテキスト・画像・動画モデルへ接続する。リクエストを送る
以下はチャット補完の例です。YOUR_MODEL_ID を対応モデルに置き換え、MAX_ROUTER_API_KEY を環境変数に設定します。画像や動画には各モデルのドキュメントに記載されたエンドポイントを使います。
curl https://maxrouterai.com/v1/chat/completions \
-H "Authorization: Bearer $MAX_ROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello!"}]}'
結果を確認する
レスポンスとエラーを確認し、ダッシュボードで使用量を確認します。まず小さなリクエストで必要なパラメーターを試してから、ストリーミングやツールを追加します。
最初のリクエストが失敗したら
モデル ID とエンドポイントが一覧の表示と一致するか確認します。認証エラーならキーと権限を、未対応のパラメータならリクエスト内容を見直します。公開の問い合わせにキーを貼らず、リクエスト ID と個人情報を除いたエラーを共有しましょう。
HTTP の成功だけでなく、本文、必要なフィールド、完了状態も確認します。失敗時はリクエスト ID と機密情報を除いたエラーを残します。認証エラーならキーと権限、無効なパラメータならリクエストを修正します。レート制限や一時的な障害は文書に従って回数を限定して再試行し、無限ループにしません。
リクエストの経路を三つに分ける
ユーザーの入力は、ブラウザからまず自分のサーバーへ送ります。サーバーはユーザーの認証と入力の確認を行い、サーバー側に保管したキーでモデルを呼び出します。必要な結果だけを画面に返せば、ブラウザの通信を見た人にプラットフォームのキーを渡さずに済みます。
問題が起きたら、画面からサーバーへ届いたか、サーバーから API へ送れたか、API が応答したかを順に確かめます。内部のリクエスト ID と状態、所要時間があれば調査しやすくなります。会話全文を記録する必要はありません。
まずコマンドラインで最小のリクエストを試し、次に同じモデル ID、URL、ヘッダー、必須項目を使ってサーバーから送ります。片方だけ失敗するなら環境変数や JSON の生成方法を、両方失敗するならアカウントとエンドポイントを確認しましょう。
応答とエラーを読み解く
成功ステータスでも、必要な内容が正しい場所にあるか確認します。空の内容、終了理由、モデルによる拒否も扱えるでしょうか。応答の構造はプロトコルによって異なるため、一つのサンプルのフィールドをすべての API に当てはめないことが大切です。
認証エラーならキーの環境、状態、権限とヘッダーを確認します。パラメータのエラーなら任意項目を外し、最小の要求から一つずつ戻します。一時的な制限は応答と文書に従って待機し、明らかな入力ミスを無限に再送しないようにします。
問い合わせには時刻、リクエスト ID、モデル ID、機密を除いたエラーを添えます。キーや顧客の入力、非公開画像の URL は含めません。漏えいが疑われるキーは投稿の削除だけで済ませず、無効化またはローテーションして使用状況を確認します。
小さく試してから公開する
通常の短い入力に加え、長い入力、必須項目の欠落、無効なキー、ユーザーによる中断を試します。画面に待機・完了・失敗が分かる表示があるか、二重クリックで余計な呼び出しが発生しないかを確認します。テストには専用の認証情報と機密を含まないデータを使います。
少人数で実際に近い作業を試し、品質、所要時間、使用量と失敗を記録します。問題が出たときは安全に再現できる最小の情報を残し、すべての失敗を自動再試行にする前に原因を調べます。公開範囲は結果を見ながら段階的に広げます。
使用したモデル ID、エンドポイント、依存ライブラリと確認日を記録しておくと、更新後に同じサンプルで比較できます。文書と挙動が異なる場合は、キーを除いた再現条件とリクエスト ID を添えてサポートに相談してください。
次の段階へ少しずつ
小さなリクエストが成功したら、実際の製品に近い入力で結果を確認します。機能は一つずつ追加し、認証情報はサーバーに置き、アクセスを増やす前に使用量を見ます。現在の制限と対応オプションはモデルの文書で確認してください。
実際の機密データを使わず、代表的な入力で品質、待ち時間、使用量、エラーを記録します。無効なキー、通信切断、ユーザーのキャンセルも試し、画面の案内を確認します。基本動作が安定してから少しずつアクセスを増やします。機能、価格、制限は変わり得るため、大きな公開前には最新の文書を確認してください。
最初に成功したモデル ID、エンドポイント、機密でない設定、確認日を記録します。小さな基準ケースがあれば、依存関係やモデル変更後に比較できます。キーや顧客の入力全文は保存しません。問い合わせには、本番ログ全体より最小限のリクエスト構造と脱敏済みエラーが役立ちます。