Skip to main content
POST
创建消息
/v1/messages 接受 Anthropic Messages API 请求正文,并返回 Anthropic 格式的响应。

流式传输

设置 stream: true 即可接收 Anthropic 格式的服务器发送事件(message_start、content_block_*、message_delta、message_stop)。

说明

  • 支持 Anthropic 工具调用字段。
  • stream: true 也适用于工具调用循环。对于 Gateway 管理的服务器工具,Phaseo 可能会处理上游工具调用轮次、继续循环,再重新发出合成流。
  • 也可以直接在 tools 中使用 Anthropic 原生网页搜索工具格式,例如 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 的格式,在服务器端执行,然后继续工具调用循环。

提供商原生网页搜索

如果兼容的 Anthropic 模型和提供商组合支持原生网页搜索,也可以直接传入原生工具定义:
执行前,提供商路由仍会检查是否支持 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日