メインコンテンツへスキップ
POST
メッセージを作成
Anthropic Messages API のペイロードを /v1/messages に送信すると、Phaseo がルーティングするどのモデルでも Anthropic 形式のレスポンスが返されます。Anthropic のツール使用フィールドに対応しており、X-Phaseo-Strictness ヘッダーでサポートされていないパラメーターの扱いを制御できます。 stream: true を設定すると、Anthropic 形式の Server-Sent Events(message_start、content_block_*、message_delta、message_stop)を受け取れます。ストリーミングはツールループでも動作します。

会話の途中でシステムメッセージを送る

会話のその時点から適用する指示は、messages に role: "system" のメッセージとして追加します。トップレベルの system フィールドは変わらないため、キャッシュされたプレフィックスは引き続きヒットします。
システムメッセージには文字列またはテキストブロックを指定します。ユーザーのターン(またはサーバーツールの結果で終わるアシスタントのターン)の直後に置き、最後のメッセージにするか、その後にアシスタントのターンを続ける必要があります。それ以外の位置では 400 が返されます。clear_at、output_config、tool_addition や tool_removal のブロックには対応していません。

サーバーツールを使う

tools に phaseo: ツールを追加すると、モデルがそれを呼び出したときに Phaseo が実行します。上流では Anthropic のツール形式に書き換え、ツールループをサーバー側で続けます。/v1/messages は phaseo:apply_patch を除くすべてのサーバーツールを受け付けます。一覧はサーバーツールガイドにあります。
サーバーツールの呼び出しは usage.server_tool_use に計数されます。以前の gateway:datetime タイプも引き続き動作します。stream: true の場合、Phaseo がツールのターンを自分で実行し、続きの回答を 1 つのストリームとして送信します。

Anthropic のネイティブ Web 検索を使う

ルーティング先の Anthropic モデルとプロバイダーがネイティブ Web 検索に対応している場合は、Anthropic のツール定義(例: type: "web_search_20250305")をそのまま渡します。実行前に、プロバイダーのルーティングで web_search_options への対応が引き続き絞り込まれます。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json

null として送信された省略可能なトップレベルのフィールドは、省略した場合と同じく未設定として扱われます。

model
string
必須
messages
object[]
必須
Minimum array length: 1
max_tokens
integer
必須
必須範囲: x >= 1
models
string[]

model の後に試行される、任意の順序付きフォールバックモデルです。model は必須で、常にプライマリモデルです。試行が 429、500、502、503、504 で失敗すると次のエントリーが試行され、その他のエラーはそのまま返されます。最大 25 個のモデル ID またはプリセットを指定でき、重複や model と同じエントリーは無視されます。各試行は個別のリクエストとして検証、記録、課金され、レスポンスの model フィールドとルーティングトレースには、リクエストを処理したモデルが表示されます。ストリーミングリクエストは最初のバイトの送信前にのみフォールバックし、動画と音楽のジョブは送信時にのみフォールバックします。Batch、realtime、council のリクエストは models を拒否します。動的ルートで設定されたフォールバックが優先され、phaseo/auto は models と併用できません。

Required array length: 1 - 25 elements
Minimum string length: 1
例:
prompt
object

プリセットに保存されたプロンプトテンプレートを埋めます。model は省略するか同じ参照を指定し、空の会話か、テンプレートの後に追加するターンを送信してください。

system
service_tier
enum<string>

対応するテキスト API で、サポートされるルーティングまたは料金のティアを選択します。

利用可能なオプション:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch,
auto,
standard_only
temperature
number
必須範囲: 0 <= x <= 1
top_p
number
必須範囲: 0 <= x <= 1
top_k
integer
必須範囲: x >= 1
tools
object[]

Anthropic 互換ツールと、ゲートウェイ管理のサーバーツールです。

tool_choice

Anthropic のツール選択オブジェクトまたは文字列です。ゲートウェイ管理のサーバーツール名も受け付け、ゲートウェイによって書き換えられます。

plugins
object[]

このリクエストで使うゲートウェイプラグイン。web は任意のモデルに Web 検索を、web-fetch はページの取得を追加します。response-healing はストリーミングしない構造化レスポンスの不正な JSON を修復します。ワークスペースとプリセットの既定値はこのリストとマージされます。不明なプラグイン ID には 400 unknown_gateway_plugin が返ります。

リクエストにサーバーツール phaseo:web_search を追加し、任意のモデルが Web を検索できるようにします。リクエストの実行、検索の計数と課金は phaseo:web_search ツールを使った場合とまったく同じです。リクエストにすでに Web 検索ツールがある場合、プラグインは何も追加しません。その他のオプションは無視されます。

stream
boolean
metadata
object
session_id
string

関連するリクエスト(会話やエージェントのワークフローなど)を可観測性のためにまとめる一意の識別子です。

Maximum string length: 256
reasoning
object
context_management
object

Anthropic のコンテキスト編集。edits には clear_tool_uses_* と clear_thinking_* の戦略を指定でき、対応するベータヘッダーとともに Anthropic に送信されます。その他のプロバイダーではこのフィールドなしでリクエストが実行され、X-Phaseo-Dropped-Params に context_management が記載されます。圧縮の編集(compact_*)は 400 を返します。

user
string

エンドユーザー識別子。Chat Completions と同じです。metadata.user_id が設定されていない場合、Claude モデルはこれを metadata.user_id として受け取ります。

prompt_cache_key
string | null

関連するリクエストをまとめ、そのプロンプトキャッシュを持つプロバイダーにとどめます。Phaseoは生のキーではなく、ワークスペースとこのキーのハッシュを上流に送ります。

stop_sequences
string[]
cache_control
object

プロンプトキャッシュの制御。type ephemeralと、任意で5mまたは1hのttlを指定します。scopeはトップレベルのClaudeキャッシュポリシーにだけ適用されます。Amazon BedrockとGoogle Vertex AIは、Claude 3.7 Sonnet、3.5 Sonnet、3 Opusを5分間しかキャッシュしません。これらのルートではttlを削除し、削除した1hはX-Phaseo-Dropped-Paramsにcache_control.ttlとして報告します。

provider_options
object

任意のプロバイダー固有オプションです。

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

ゲートウェイのデバッグ設定です。これらのフラグがプロバイダーに転送されることはありません。

provider
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

レスポンス

メッセージの応答

id
string
type
string
role
enum<string>
利用可能なオプション:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object
context_management
object

リクエストで context_management を使用し、Anthropic が編集を適用した場合に含まれます。applied_edits には各編集と、それによって消去された内容が記載されます。ストリームでは最後の message_delta イベントに含まれます。

最終更新日 2026年11月5日