APIMaster.ai

リクエスト単位のルーティング制御

任意の 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/completions
  • POST /v1/responses
  • POST /v1/messages
  • POST /v1beta/models/{model}:generateContent
  • POST /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 を返し、配信中ならストリームを終了します。