サービス階層は現在、対応プロバイダーの対応テキストモデルでのみ利用できます。
service_tierは、3種類すべてのテキストリクエストAPIで利用できます。
- Anthropic互換のMessages(
/v1/messages) - OpenAI互換のChat Completions(
/v1/chat/completions) - OpenAI互換のResponses(
/v1/responses)
階層の概要
API互換性
対応する同期テキストAPIを呼び出すときは、同じservice_tierフィールドを使います。
service_tierで指定できる値はstandard、fast、ultrafast、priority、flex、batchです。service_tierを省略した場合はStandardがデフォルトです。Phaseoではプレミアム階層の正式名称にFastを使います。OpenAIルートでは、プロバイダー互換エイリアスのpriorityも受け付け、同じルーティングと料金が適用されます。Batchは同期テキストリクエストではなくBatch APIで処理します。
Phaseoは正規化されたGatewayの値を、内部でプロバイダー固有の設定にマッピングします。たとえばAnthropicルートでは上流にAnthropic固有の階層フィールドを送る場合がありますが、クライアント側のリクエストではここに記載したGatewayの値を使います。
Standard
Standardはデフォルトのルーティングモードです。使用するためにservice_tierを設定する必要はありません。
Fast
プロバイダーのプレミアムまたは優先度の高いオプションを使う場合はFastを選びます。Phaseoではプロバイダーに依存しない名称としてfastを使います。OpenAIではFastモードと呼ばれ、対応モデルでfastとpriorityの両方を指定できます。
Anthropic Messagesの例
Mistral PriorityとEUルーティング
Mistral Priority Tierの利用には、対象となるMistralエンタープライズアカウントが必要です。PhaseoはpriorityをMistralの自動優先モードに割り当て、Mistralが報告した階層で課金します。
MistralがStandardに戻った場合はStandardの料金が適用されます。
GLM 5.2は、mistral-euプロバイダーオファーを使ってMistralのEUリージョナルエンドポイントに固定できます。
プロバイダーオファー:
Ultrafast
モデルとプロバイダーが対応している場合、最高速のサービス階層にはUltrafastを使います。PhaseoはUltrafast料金またはUltrafast専用のルートだけを使い、この階層が利用できなくてもFastやStandardにフォールバックしません。
Flex
プロバイダーが低コストのサービス階層を提供しており、その料金モードに伴うトレードオフを許容できる場合はFlexを使います。
Chat Completionsの例
Responsesの例
Batch
batchはバッチ実行用の有効な階層値ですが、同期テキストAPIではservice_tier: "batch"を指定すると、Batch APIを案内する検証エラーになります。
Batch料金は通常の同期リクエストではなく遅延バッチ実行に適用されるため、Batch APIまたはバッチジョブのワークフローを使ってください。
注意事項
- 階層の対応状況はプロバイダーとモデルによって異なります。
- 料金データがある場合、モデルページの料金カードに階層ごとの料金が表示されます。
- 一部のプロバイダーは専用の上流オファーを提供しており、Phaseoはそれらをカタログ内で統一された階層として扱います。
- クライアント向けの
service_tier値は対応するテキストAPI間で統一され、プロバイダー固有の名称はGateway内で処理されます。