Skip to Content
API 参考Anthropic

Anthropic 兼容接口

使用本接口调用蚂蚁百灵模型,支持多轮对话、长程任务等对话场景。接口格式与 Anthropic messages 完全兼容,可直接使用 Anthropic SDK 接入。

请求地址

方法地址
POSThttps://api.ant-ling.com/anthropic/v1/messages

授权

调用 Anthropic 兼容接口时,Authorizationx-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

请求体

概览

参数类型必填默认值说明
modelstring模型 ID
messagesobject[]消息列表
max_tokensinteger32000最大输出 Token 数
streambooleanfalse是否启用流式输出
systemobject[]系统提示词
toolsobject[]工具列表(Function Calling)
tool_choiceobjectauto工具使用策略
stop_sequencesstring[]停止词列表
temperaturedouble1随机性,范围 [0.0, 1.0]
top_pdouble1多样性,范围 (0.0, 1.0]

model

  • 类型string
  • 必填
  • 说明:要调用的模型 ID。
  • 可选值Ling-2.6-1TLing-2.6-flashLing-2.5-1TLing-1TRing-2.5-1TRing-1T

messages

  • 类型object[]
  • 必填
  • 说明:提供给模型的消息列表,按对话顺序排列。支持 texttool_usetool_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 --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  格式返回,每个事件包含 eventdata 两行,以 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