リクエスト単位のルーティング制御
任意の HTTP ヘッダーで、テキスト生成の公式価格に対する上限、再試行回数、全体の制限時間を指定できます。
リクエスト単位のルーティング制御
チャネルを指定または除外
テキスト・画像・動画の生成リクエストにチャネルの範囲を設定できます。両方のヘッダーを併用でき、除外が優先されます。
X-APIMaster-Include-Channels· 列挙したチャネルのみを許可します。X-APIMaster-Exclude-Channels· 列挙したチャネルを除外します。
各ヘッダーはカンマ区切りの正の整数を最大 64 個受け付けます。モデルの公開 channel_id を照会できます。利用可能な範囲は API キーとコンソール設定で決まります。チャネルがリクエストの操作とパラメータに対応している必要もあります。
curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"
再試行とフォールバックも同じ範囲に従います。非同期生成では範囲を保存し、冪等送信に対応する API では冪等性の検査に含めます。
形式が無効な場合は 400 invalid_routing_parameter、該当するチャネルがない場合は 503 no_provider_within_channel_scope を返します。照会とダウンロードでは元のタスクのチャネルを使用します。
結果の照会やダウンロード時にはこれらのヘッダーを省略してください。非対応のエンドポイントと管理対象の FreeModel プールは 400 routing_controls_unsupported を返します。
生成の例
curl "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Exclude-Channels: $TEXT_CHANNEL_ID" \
-d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with OK."}]}'
curl "https://apimaster.ai/v1/images/generations/async" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $IMAGE_CHANNEL_ID" \
-d '{"model":"gpt-image-2","prompt":"A blue ceramic cup on a white table","size":"1024x1024"}'
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $VIDEO_CHANNEL_ID" \
-d '{"model":"wan3.0-video-prime","prompt":"A flower sways in a light breeze","duration":2,"resolution":"480P"}'
テキストの料金、再試行、期限
任意の HTTP ヘッダーで、テキスト生成の公式価格に対する上限、再試行回数、全体の制限時間を指定できます。
| ヘッダー | 動作 |
|---|---|
X-APIMaster-Max-Official-Price-Ratio |
公式価格に対する上限比率を正の数で指定します。0.5 は公式価格の半額まで、1 は公式価格と同額まで許可します。 |
X-APIMaster-Max-Retries |
初回送信後に許可する追加試行の最大回数を、0 以上の整数で指定します。0 は初回の 1 回のみです。プロバイダーの切り替えや公式プロバイダーへの切り替えも含みます。 |
X-APIMaster-Timeout-Ms |
ゲートウェイが受信してからの制限時間を、ミリ秒単位の正の整数で指定します。経路選択、再試行、ストリーミングを含みます。プラットフォームの制限が短ければ、そちらが適用されます。 |
各ヘッダーは単独で使えます。省略した項目には既存のポリシーが適用され、コンソールのプロバイダー設定も引き続き有効です。上限は入力、出力、該当するキャッシュの単価に適用されます。合計料金は使用量によって変わります。生成内容の配信開始後、別のプロバイダーで最初から生成し直すことはありません。
対応エンドポイント
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent
対象はテキスト生成です。画像、動画など未対応のエンドポイントで指定すると 400 routing_controls_unsupported を返します。ツール呼び出しなど個別に課金される項目は、テキスト単価の上限の対象外です。
例
curl https://apimaster.ai/v1/chat/completions \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Max-Official-Price-Ratio: 0.5" \
-H "X-APIMaster-Max-Retries: 1" \
-H "X-APIMaster-Timeout-Ms: 30000" \
-d '{"model":"gpt-6.2-sol","messages":[{"role":"user","content":"Reply with OK."}]}'
エラー
無効な値は 400 invalid_routing_parameter、公式価格を確認できない場合は 400 official_price_unavailable になります。上限を満たすプロバイダーがなければ、送信前に 503 no_provider_within_price_limit を返します。制限時間に達すると、応答開始前なら 504 request_deadline_exceeded を返し、配信中ならストリームを終了します。
