Anthropic 兼容接口
使用本接口调用蚂蚁百灵模型,支持多轮对话、长程任务等对话场景。接口格式与 Anthropic messages 完全兼容,可直接使用 Anthropic SDK 接入。
请求地址
| 方法 | 地址 |
|---|---|
POST | https://api.ant-ling.com/anthropic/v1/messages |
授权
调用 Anthropic 兼容接口时,Authorization 与 x-api-key 均可用于验证身份,二选一必填。
Authorization
- 类型:
HTTP Bearer Auth,值类型string - 必填(与
x-api-key二选一) - 说明:用于验证账户信息。前往API 控制台 ,点击创建令牌获取。
Authorization: Bearer <YOUR_API_KEY>x-api-key
- 类型:
string - 必填(与
Authorization二选一) - 说明:用于验证账户信息。前往API 控制台 ,点击创建令牌获取。
x-api-key: <YOUR_API_KEY>请求头
Content-Type
- 类型:
enum<string> - 必填,固定值
application/json - 说明:请求体的媒体类型,必须为
application/json。
请求体
概览
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | — | 模型 ID |
messages | object[] | 是 | — | 消息列表 |
max_tokens | integer | 否 | 32000 | 最大输出 Token 数 |
stream | boolean | 否 | false | 是否启用流式输出 |
system | object[] | 否 | — | 系统提示词 |
tools | object[] | 否 | — | 工具列表(Function Calling) |
tool_choice | object | 否 | auto | 工具使用策略 |
stop_sequences | string[] | 否 | — | 停止词列表 |
temperature | double | 否 | 1 | 随机性,范围 [0.0, 1.0] |
top_p | double | 否 | 1 | 多样性,范围 (0.0, 1.0] |
model
- 类型:
string - 必填
- 说明:要调用的模型 ID。
- 可选值:
Ling-2.6-1T、Ling-2.6-flash、Ling-2.5-1T、Ling-1T、Ring-2.5-1T、Ring-1T
messages
- 类型:
object[] - 必填
- 说明:提供给模型的消息列表,按对话顺序排列。支持
text、tool_use、tool_result三种内容类型。
[{ "role": "user", "content": "你好" }]messages.role
- 类型:
string - 必填
- 说明:消息发送者的角色。
- 可选值:
user(用户)、assistant(助手)
messages.content
- 类型:
string - 必填
- 说明:发送给模型的消息内容。
- 示例:
你好,蚂蚁百灵
max_tokens
- 类型:
integer - 非必填,默认
32000 - 说明:限制模型单次响应的最大输出 Token 数。
stream
- 类型:
boolean - 非必填,默认
false - 说明:设为
true时启用流式输出,服务端以 SSE 格式逐块返回内容。
非流式调用的超时时间为 90 秒。对于较长的生成任务,建议开启 stream: true 以避免超时。
system
- 类型:
object[] - 非必填
- 说明:系统提示词,用于设定模型的角色或行为。
[
{
"type": "text",
"text": "你是一个智能对话助手"
}
]tools
- 类型:
object[] - 非必填
- 说明:工具列表(Function Calling)。模型可在回复中调用这些工具。
[
{
"name": "search_city_weather",
"description": "搜索城市天气",
"input_schema": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "城市名称"
},
"date": {
"type": "string",
"description": "yyyy-mm-dd 格式的日期"
}
},
"required": ["city", "date"]
}
}
]tool_choice
- 类型:
object - 非必填,默认
{ "type": "auto" } - 说明:控制模型使用工具的方式。
- 可选类型:
auto(模型自行决定)、any(必须使用工具)、tool(指定使用某个工具)、none(禁止使用工具)
stop_sequences
- 类型:
string[] - 非必填
- 说明:停止词列表。模型在输出过程中遇到列表中的字符串时会提前停止生成。
temperature
- 类型:
double - 非必填,默认
1 - 说明:控制输出的随机性。取值范围
[0.0, 1.0],值越小输出越确定,值越大输出越多样。
top_p
- 类型:
double - 非必填,默认
1 - 说明:核采样概率阈值。取值范围
(0.0, 1.0],值越小模型越倾向于高概率词汇。
请求与响应
请求示例
流式调用
cURL
curl --request POST \
--url https://api.ant-ling.com/anthropic/v1/messages \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "Ling-2.6-flash",
"stream": true,
"messages": [
{
"role": "user",
"content": "2025 年中国大模型行业将面临哪些机遇与挑战?"
}
]
}'响应示例
流式响应
流式响应以 SSE 格式返回,每个事件包含 event 和 data 两行,以 message_stop 事件结束。
event: message_start
data: {"message":{"content":[],"id":"0be8c630...","model":"Ling-2.6-flash","role":"assistant","type":"message","usage":{"input_tokens":0,"output_tokens":0}},"type":"message_start"}
event: content_block_start
data: {"content_block":{"text":"","type":"text"},"index":0,"type":"content_block_start"}
event: content_block_delta
data: {"delta":{"text":"你好","type":"text_delta"},"index":0,"type":"content_block_delta"}
event: content_block_delta
data: {"delta":{"text":"!有什么我可以帮你的吗?","type":"text_delta"},"index":0,"type":"content_block_delta"}
event: content_block_stop
data: {"index":0,"type":"content_block_stop"}
event: message_delta
data: {"delta":{"stop_reason":"end_turn"},"type":"message_delta","usage":{"input_tokens":19,"output_tokens":21}}
event: message_stop
data: {"type":"message_stop"}Was this page helpful?
Last updated on