Anthropic 兼容

标准 Anthropic Messages 兼容路径,适合 Anthropic SDK 与已有 Anthropic 代码迁移。

POST/api/v1/messages

Anthropic 兼容

标准 Anthropic Messages 兼容路径;历史路径 /api/anthropic/v1/messages 继续兼容。

Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。
先确认模型调用名请先在 模型广场 筛选支持当前接口格式的模型,打开模型详情页复制调用名。当前账号的最终可用范围还受组织权限影响。

请求结构

下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。

HTTP
POST https://www.silvamux.com/api/v1/messages
Authorization: Bearer $SILVAMUX_API_KEY
Content-Type: application/json

请求体

application/json · AnthropicRequest · 必填

字段类型必填说明
max_tokensinteger是单次响应允许生成的最大 token 数。
messagesarray<AnthropicMessage>是对话消息列表(按时间顺序)。
messages.contentstring | array<AnthropicContentBlock>是消息内容:字符串或内容块数组。
messages.rolestring (user | assistant)是消息角色(system 是顶层参数,不是消息角色)。
metadataobject否请求元数据。
metadata.user_idstring否终端用户标识符。
modelstring是SilvaMux 模型调用名(id 或 alias)。从模型广场模型详情页复制。
stop_sequencesarray<string>否停止序列列表。
streamboolean否是否启用流式输出(SSE)。;默认值:false
systemstring | array<AnthropicTextBlock>否系统提示(顶层参数)。
temperaturenumber否采样温度,控制输出随机性。
tool_choiceAnthropicToolChoice否—
tool_choice.namestring否type=tool 时指定的工具名。
tool_choice.typestring (auto | any | tool)是auto 模型自行决定;any 必须调用其中之一;tool 指定工具。
toolsarray<AnthropicTool>否可用工具列表。
tools.descriptionstring否工具用途描述。
tools.input_schemaobject是入参的 JSON Schema。
tools.namestring是工具名。
top_kinteger否仅从概率前 k 的候选中采样。
top_pnumber否核采样参数,temperature 的替代方案。

响应

200Anthropic Messages JSON 或 SSE 响应。

application/json · AnthropicMessageResponse

字段类型说明
contentarray<AnthropicTextBlock | AnthropicToolUseBlock>响应内容块列表。
idstring消息 ID。
modelstring实际使用的模型名。
rolestring (assistant)—
stop_reasonstring (end_turn | max_tokens | stop_sequence | tool_use)结束原因。
stop_sequencestring命中的停止序列。
typestring (message)—
usageobject—
usage.input_tokensinteger输入 token 数。
usage.output_tokensinteger输出 token 数。

defaultAnthropic 兼容错误。

application/json · AnthropicError

字段类型说明
errorobject—
error.messagestring—
error.typestring—
typestring (error)—
历史路径 /api/anthropic/v1/messages 继续兼容,仅供已接入项目使用,新项目应使用 /api/v1/messages。

示例

curl https://www.silvamux.com/api/v1/messages \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

响应(Anthropic 格式):

{
  "id": "msg_xxxx",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "你好!有什么可以帮你的吗?"}],
  "usage": {"input_tokens": 10, "output_tokens": 15}
}

流式遵循 Anthropic SSE 规范。