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] |
thinking | object | 否 | — | 是否开启思考模式（3.0 系列模型、3.1 系列模型） |
model
- 类型：
string - 必填
- 说明：要调用的模型 ID。
- 可选值：
Ling-3.1-flash、Ling-3.0-flash-VL、Ling-3.0-flash、Ling-3.0-tiny、AntAngelMed
接入 Ling-3.0-flash-VL 时，Messages 支持在 Ling-VL 中输入文本、图片。详情请见多模态理解。
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]，值越小模型越倾向于高概率词汇。
thinking
- 类型：
object - 非必填
- 说明：控制是否开启思考模式。3.0 系列模型、3.1 系列模型支持此参数。
thinking.type
- 类型：
string - 非必填，默认
enabled - 说明：控制 3.0 系列模型、3.1 系列模型是否开启推理
- 可选值：
enabled— 默认值。开启深度思考，适用于较复杂的任务。disabled— 不开启深度思考，适用于对速度要求较高的场景。
请求与响应
请求示例
流式调用
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-3.1-flash",
"stream": true,
"messages": [
{
"role": "user",
"content": "2025 年中国大模型行业将面临哪些机遇与挑战？"
}
]
}'响应示例
流式响应
流式响应以 SSE 格式返回，每个事件包含 event 和 data 两行，以 message_stop 事件结束。
event:message_start
data:{"message":{"id":"218edb9317796992094813867eb6fe","content":[],"model":"Ling-3.1-flash","role":"assistant","type":"message","usage":{"input_tokens":0,"output_tokens":0}},"type":"message_start","id":"218edb9317796992094813867eb6fe"}
event:content_block_start
data:{"content_block":{"text":"","type":"text"},"index":0,"type":"content_block_start","id":"218edb9317796992094813867eb6fe"}
event:content_block_delta
data:{"delta":{"text":"你好","type":"text_delta"},"index":0,"type":"content_block_delta","id":"218edb9317796992094813867eb6fe"}
event:content_block_delta
data:{"delta":{"text":"！","type":"text_delta"},"index":0,"type":"content_block_delta","id":"218edb9317796992094813867eb6fe"}
event:content_block_delta
data:{"delta":{"text":"有什么","type":"text_delta"},"index":0,"type":"content_block_delta","id":"218edb9317796992094813867eb6fe"}
event:content_block_delta
data:{"delta":{"text":"我可以","type":"text_delta"},"index":0,"type":"content_block_delta","id":"218edb9317796992094813867eb6fe"}
event:content_block_delta
data:{"delta":{"text":"帮你的","type":"text_delta"},"index":0,"type":"content_block_delta","id":"218edb9317796992094813867eb6fe"}
event:content_block_delta
data:{"delta":{"text":"吗？","type":"text_delta"},"index":0,"type":"content_block_delta","id":"218edb9317796992094813867eb6fe"}
event:content_block_stop
data:{"index":0,"type":"content_block_stop","id":"218edb9317796992094813867eb6fe"}
event:message_delta
data:{"delta":{"stop_reason":"end_turn","stop_sequence":null},"type":"message_delta","usage":{"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":20,"output_tokens":10},"id":"218edb9317796992094813867eb6fe"}
event:message_stop
data:{"type":"message_stop","id":"218edb9317796992094813867eb6fe"}这个页面对你有帮助吗?
Last updated on