Skip to main content
POST
メッセージを作成
/v1/messages は Anthropic Messages API のリクエスト形式を受け取り、Anthropic 形式の応答を返します。

ストリーミング

stream: true を設定すると、Anthropic 形式の Server-Sent Events(message_start、content_block_*、message_delta、message_stop)を受信できます。

補足

  • Anthropic のツール使用フィールドに対応しています。
  • stream: true はツールループでも利用できます。Gateway 管理サーバーツールでは、Phaseo が上流のターンを処理してループを続行し、合成ストリームを再送する場合があります。
  • Anthropic ネイティブの Web 検索ツール形式も tools で直接指定できます。例: type: "web_search_20250305"。
  • X-Phaseo-Strictness ヘッダーで、未対応パラメーターの扱いを制御します。

サーバーツール

/v1/messages は次の Gateway 管理サーバーツールにも対応しています。
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
Phaseo はこれらのツールを上流プロバイダー向けの Anthropic 互換形式に変換してサーバー側で実行し、ツールループを続行します。

プロバイダーのネイティブ Web 検索

互換性のある Anthropic モデルとプロバイダーの組み合わせがネイティブ Web 検索に対応している場合は、ネイティブのツール定義を直接渡すこともできます。
実行前に、プロバイダーのルーティングで web_search_options の対応状況が引き続き確認されます。

日時の例

使用すると、usage.server_tool_use.* カウンターにサーバーツールの呼び出し回数が記録されます。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json
model
string
必須
messages
object[]
必須
Minimum array length: 1
max_tokens
integer
必須
必須範囲: x >= 1
system
service_tier
enum<string>

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

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

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

tool_choice

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

stream
boolean
metadata
object
session_id
string

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

Maximum string length: 256
reasoning
object
stop_sequences
string[]
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
最終更新日 2026年10月2日