AIHub 在 https://ai.yunxinapi.com/hub/v1 下提供 Anthropic Messages 入口。已有 OpenAI SDK 代码通常只需替换 Base URL、API Key 和模型名称即可接入。

请求 URL

httpPOST https://ai.yunxinapi.com/hub/v1/messages

同协议 Anthropic 路由会优先保留原始请求体并转发到上游，因此 Anthropic 原生字段可以随请求进入渠道；跨协议 bridge 路由仅保证 model、messages、max_tokens 等稳定语义。

请求头

以下两种鉴权方式至少提供一种。同时存在时，Authorization 优先。

Header	必填	说明
Authorization	否	AIHub 访问令牌，格式为 Bearer <AIHUB_TOKEN>
X-Api-Key	否	Anthropic SDK 常用鉴权头；未传 Authorization 时，AIHub 可将其作为访问令牌
Anthropic-Version	否	Anthropic SDK 常用版本头；模型列表接口会结合该头识别 Anthropic 响应形状
Content-Type	是	固定使用 application/json

请求体参数

核心参数

字段	类型	必填	说明
model	string	是	AIHub 逻辑模型名，用于模型授权、限流、路由选择和上游模型映射。
- messages	object[]	是	对话消息数组，按上下文顺序传入。
role	string	是	消息角色：user、assistant。
- content	string/object[]	是	消息内容，可为纯文本或内容块数组。
type	string	是	内容块类型：text、image、tool_use、tool_result
text	string	否	type=text 时的文本内容。
source	object	否	type=image 时的图片来源。
id	string	否	工具调用块 ID。
name	string	否	工具名称。
input	object	否	工具调用入参。
tool_use_id	string	否	工具结果关联的工具调用 ID。
is_error	bool	否	工具结果是否表示错误。
max_tokens	int	是	最大输出 token 数。Anthropic SDK 通常要求显式传入。
system	string/object[]	否	系统提示词，可为字符串或内容块数组。
stream	bool	否	是否启用 SSE 流式输出，true 时请求模式为流式。

采样控制参数

字段	类型	必填	说明
temperature	number	否	随机性控制，值越高输出越发散。
top_p	number	否	nucleus sampling 参数。
top_k	int	否	候选 token 截断参数。
stop_sequences	string[]	否	停止序列列表。

工具与扩展参数

字段	类型	必填	说明
- tools	object[]	否	工具定义数组。
name	string	是	工具名称。
description	string	否	工具说明。
input_schema	object	否	工具入参 JSON Schema。
tool_choice	object	否	工具选择策略，如 {"type":"auto"} 或指定工具。
metadata	object	否	客户侧元数据，透传给支持该字段的上游。
thinking	object	否	Anthropic thinking 配置（如 type、budget_tokens）；支持情况取决于模型。
mcp_servers	object[]	否	MCP server 配置；支持情况取决于上游。
container	object	否	Anthropic 容器上下文配置。
context_management	object	否	上下文管理配置。
output_config	object	否	输出配置，部分渠道用于提取 effort 等参数。
output_format	object	否	输出格式配置。
cache_control	object	否	缓存控制扩展字段。
service_tier	string	否	上游服务层级。默认会被过滤，需渠道允许后才透传。

请求示例

bashcurl "https://ai.yunxinapi.com/hub/v1/messages" \
  -H "Authorization: Bearer $AIHUB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$AIHUB_MODEL"'",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "hello"}
    ]
  }'

成功响应

非流式响应默认保持 Anthropic Messages 格式。

字段	类型	说明
id	string	响应 ID。
type	string	对象类型，通常为 message。
role	string	响应角色，通常为 assistant。
model	string	实际响应模型名，可能是上游模型名。
content	object[]	输出内容块列表。
stop_reason	string	停止原因：end_turn、max_tokens、tool_use 。
stop_sequence	string	命中的停止序列。
usage	object	token 用量，包含 input_tokens、output_tokens 及缓存 token 细分。

流式输出

设置 "stream": true 后，接口返回 Anthropic SSE 事件流。请求进入 AIHub 后会经过标准推理数据面链路，再由可用供应商渠道执行。

上游厂商参数映射

Anthropic Messages 入口优先服务 Anthropic-compatible 上游；若路由到 OpenAI family bridge，AIHub 会先将 Anthropic 请求收敛为内部 Chat 语义，再转成目标厂商协议。

目标上游/渠道类型	上游接口	AIHub 入参到上游参数	说明
Anthropic/Anthropic-compatible passthrough	POST https://ai.yunxinapi.com/hub/v1/messages	model 映射为渠道配置的上游模型名；messages、system、max_tokens、tools、tool_choice、thinking 等按 Anthropic 同名字段进入上游	同协议路由优先保留原始请求体，厂商 beta 字段是否生效取决于渠道和模型
Bedrock Anthropic	Bedrock Claude messages/runtime 接口	model 映射为 Bedrock model id；消息、系统提示、工具块按 Anthropic 语义发送	具体 header 和运行时路径由 Bedrock provider 处理
OpenAI family bridge	POST https://ai.yunxinapi.com/hub/v1/chat/completions 或厂商兼容路径	system -> 开头 system 消息；messages 文本块 -> OpenAI messages[].content；assistant tool_use -> OpenAI tool_calls；tool_result -> role=tool	bridge 只保证文本和工具调用闭环；max_tokens、temperature、top_p、tools、tool_choice、thinking 等 Anthropic native-only 字段不保证保留

常见字段对应关系：

AIHub 字段	Anthropic-compatible 上游	Bedrock Anthropic 上游	OpenAI family bridge
model	body.model，值为渠道映射后的上游模型名	Bedrock model id	OpenAI-compatible body.model
system	body.system	Anthropic system 语义	prefix system message
messages[].content[type=text]	Anthropic text block	Anthropic text block	OpenAI message string content
messages[].content[type=image]	Anthropic image block	模型支持时发送	不保证保留
messages[].content[type=tool_use]	Anthropic tool_use block	Anthropic tool use 语义	OpenAI assistant tool_calls
messages[].content[type=tool_result]	Anthropic tool_result block	Anthropic tool result 语义	OpenAI role=tool message
max_tokens/temperature/top_p/top_k	同名字段	按 Bedrock/Claude 能力处理	不保证保留
thinking/mcp_servers/container	Anthropic 原生字段	取决于 Bedrock/Claude 支持	不保证保留

路由方式

具体候选渠道取决于模型授权、访问组、渠道模型映射、路由绑定和运行时健康状态。