通过兼容 Anthropic 格式的 Messages API 调用模型,查看输入输出参数说明及调用示例。
api_key:替换为百炼 API Key。base_url:替换为百炼的兼容端点地址(见下方接入信息)。model:替换为百炼支持的模型名称(例如qwen3.7-plus)。
- 华北2(北京)
- 新加坡
- 美国(弗吉尼亚)
- 德国(法兰克福)
- 日本(东京)
base_url:https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropicHTTP 请求地址:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1/messages{WorkspaceId}替换为真实的业务空间ID。
认证方式:通过 x-api-key 请求头或 Authorization: Bearer 请求头传入百炼 API Key,二者选其一即可。
与 Anthropic 官方 API 的主要差异
以下差异点汇总自本文正文,从 Anthropic 官方迁移时请重点确认:
差异项 | 说明 |
接入地址(Base URL) |
|
鉴权方式 |
|
模型名称 |
|
temperature 取值范围 | 百炼取值范围为 [0, 2),与 Anthropic 官方的 [0.0, 1.0] 不同,迁移时请确认该参数取值。 |
接口范围 | 仅提供 Messages 接口( |
扩展参数 |
|
请求体modelstring (必选)模型名称,支持范围如下。
支持的模型列表 千问Max:qwen3.8-max、qwen3.7-max、qwen3.7-max-2026-05-20、qwen3.7-max-2026-06-08、qwen3.6-max-preview、qwen3-max、qwen3-max-2026-01-23、qwen3-max-preview千问Plus:qwen3.7-plus、qwen3.7-plus-2026-05-26、qwen3.6-plus、qwen3.6-plus-2026-04-02、qwen3.5-plus、qwen3.5-plus-2026-04-20、qwen3.5-plus-2026-02-15、qwen-plus、qwen-plus-latest、qwen-plus-2025-09-11千问Flash:qwen3.8-flash、qwen3.7-flash、qwen3.7-flash-2026-07-15、qwen3.6-flash、qwen3.6-flash-2026-04-16、qwen3.5-flash、qwen3.5-flash-2026-02-23、qwen-flash、qwen-flash-2025-07-28千问Turbo:qwen-turbo千问Coder:qwen3-coder-next、qwen3-coder-plus、qwen3-coder-plus-2025-09-23、qwen3-coder-flash千问VL:qwen3-vl-plus、qwen3-vl-flash、qwen-vl-max、qwen-vl-plus千问开源模型:qwen3.6-27b、qwen3.5-397b-a17b、qwen3.5-122b-a10b、qwen3.5-27b、qwen3.5-35b-a3b、qwen3.8-2.4t-a95b、qwen3.8-27b第三方模型deepseek-v4-pro、deepseek-v4-pro-0813、deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v3.2、kimi-k3、kimi-k2.7-code、kimi-k2.6、kimi-k2.5、kimi-k2-thinking、glm-5.2、glm-5.1、glm-5、glm-4.7、glm-4.6、MiniMax-M2.5、MiniMax-M2.1 integer (必选)
string 或 array (可选)系统提示词,用于设定模型的角色或行为。传入字符串等价于单个 type="text" 的内容块。当需要为系统提示词标记显式缓存断点(参见右侧"显式缓存"示例)时,必须传入数组形式。
属性 type string (必选)固定为 text。text string (必选)系统提示词文本。cache_control object (可选)在该内容块上标记显式缓存断点(参见右侧"显式缓存"示例),命中后第二次及之后的请求按缓存读取计费。仅包含字段 type,取值固定为 ephemeral。array (必选)
messages 数组元素 role string (必选)消息角色,可选值:user、assistant、system。content string 或 array (必选)消息内容。可以是纯文本字符串,也可以是结构化内容数组。content 为字符串时,等价于单个 type="text" 的内容块。
content 数组元素类型 文本信息
属性 type string (必选)固定为 text。text string (必选)文本内容。cache_control object (可选)在该文本块上标记显式缓存断点(参见右侧"显式缓存"示例)。仅包含字段 type,取值固定为 ephemeral。
属性 type string (必选)固定为 image。source object (必选)图片数据来源。
属性 type string (必选)取值:url(公网图片地址)、base64(Base64 编码)。url string图片的公网地址。当 type 为 url 时必填。media_type string图片的 MIME 类型,如 image/jpeg。当 type 为 base64 时必填。data stringBase64 编码的图片数据。当 type 为 base64 时必填。
属性 type string (必选)固定为 video。source object (必选)视频数据来源。
属性 type string (必选)取值:url(公网视频地址)、base64(Base64 编码)。url string视频的公网地址。当 type 为 url 时必填。media_type string视频的 MIME 类型,如 video/mp4。当 type 为 base64 时必填。data stringBase64 编码的视频数据。当 type 为 base64 时必填。
属性 type string (必选)固定为 tool_use。id string (必选)工具调用的唯一标识,用于在后续 tool_result 中关联结果。name string (必选)被调用的工具名称。input object (必选)工具调用的入参,结构由 tools 中对应工具的 input_schema 决定。cache_control object (可选)在该块上标记显式缓存断点(参见右侧"显式缓存"示例)。仅包含字段 type,取值固定为 ephemeral。工具调用内容本身会参与缓存前缀。
属性 type string (必选)固定为 tool_result。tool_use_id string (必选)对应 tool_use 信息中的 id。content string (必选)工具执行返回的内容。cache_control object (可选)在该工具结果块上标记显式缓存断点(参见右侧"显式缓存"示例)。仅包含字段 type,取值固定为 ephemeral。boolean (可选)是否启用流式输出,默认为 false。temperature number (可选)控制生成文本的多样性,取值范围 [0, 2)。值越大,生成结果越随机。该范围与 Anthropic 官方的 [0.0, 1.0] 不同,从 Anthropic 迁移时请确认该参数取值。 number (可选)核采样的概率阈值,控制生成文本的多样性。top_k integer (可选)生成过程中采样候选集的大小。stop_sequences array (可选)指定停止生成的文本序列。模型生成到该序列前会停止输出,且不包含该序列本身。命中后,响应的 stop_reason 仍为 end_turn,响应不会回填命中的序列。object (可选)深度思考配置。开启后,模型会在生成回复前先进行推理,以提升回答准确度。开启后,响应会包含 thinking 类型的内容块。未传入该参数时,是否进行思考由模型默认行为决定:qwen3.8-max、qwen3.8-flash、deepseek-v4 系列、glm 系列默认开启思考;kimi-k2.6、kimi-k2.5 默认关闭思考;kimi-k2.7-code、kimi-k2-thinking、MiniMax-M2.5、MiniMax-M2.1 仅支持思考模式(无法关闭)。各模型对思考模式的支持情况与默认开关,请参见深度思考。
属性 type string (必选)可选值:enabled(开启思考模式)、disabled(关闭思考模式)。budget_tokens integer (可选,即将废弃)
该参数即将废弃,并将在后续模型中逐步停止支持,新接入建议使用 思考过程可使用的最大 Token 数,与 max_tokens 互不重叠:本参数限制思考,max_tokens 限制最终回复。预算越大,在复杂问题上的分析越充分。当 type 为 enabled 时生效。array (可选)工具定义数组,用于 Function Call 场景。
tools 数组元素 name string (必选)工具名称。description string (可选)工具的功能描述。input_schema object (必选)工具输入参数的 JSON Schema 定义。object (可选)工具选择策略。支持以下值:
object (可选)输出参数设置。
属性 effort string (可选)控制模型的推理力度。
object (可选)结构化输出配置。开启后,模型将输出 JSON 字符串。不同模型的支持力度不同:
属性 type string (必选)取值固定为 json_schema。schema object (必选)JSON Schema 对象,遵循标准 JSON Schema 规范。需包含 type(数据类型)、properties(字段定义)、required(必填字段名数组)、additionalProperties(必须设为 false)等字段。 |
Python |
非流式响应idstring消息的唯一标识。type string固定为 message。role string固定为 assistant。model string使用的模型名称。content array内容数组。
content 数组元素类型 文本信息
属性 type string固定为 text。text string模型生成的文本回复。
属性 type string固定为 thinking。thinking string模型在生成最终回复前的思考过程。signature string当前固定为空字符串。
属性 type string固定为 tool_use。id string工具调用的唯一标识,用于在后续 tool_result 中关联结果。name string被调用的工具名称。input object工具调用的入参。string停止原因。可选值:end_turn(正常结束)、max_tokens(达到 Token 上限)、tool_use(工具调用)。stop_sequence string固定为 null。usage objectToken 用量统计。流式调用中, message_start 事件的 usage 仅包含 input_tokens 和 output_tokens;完整 4 个字段在 message_delta 事件中返回。
属性 input_tokens integer输入 Token 数量。output_tokens integer输出 Token 数量。cache_creation_input_tokens integer缓存创建消耗的输入 Token 数量。cache_read_input_tokens integer缓存读取消耗的输入 Token 数量。 | 响应示例 |
流式响应message_start流的第一个事件,标记消息开始。
属性 type string固定为 message_start。message object初始消息对象,content 为空数组,usage 仅含 input_tokens 和 output_tokens。
属性 type string固定为 content_block_start。index integer内容块索引,从 0 开始,对应该消息 content 数组中的位置。content_block object内容块的初始对象。type 取值为 text、thinking 或 tool_use。tool_use 类型在此事件中 input 为空对象,完整入参由后续 content_block_delta 增量拼接。
属性 type string固定为 content_block_delta。index integer所属内容块索引。delta object增量对象,type 取值:
属性 type string固定为 content_block_stop。index integer结束的内容块索引。
属性 type string固定为 message_delta。delta object包含 stop_reason 和 stop_sequence,取值参见上方非流式响应表格。usage object完整的 Token 用量统计,包含 input_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens。
属性 type string固定为 message_stop。此外,流式响应还会定期发送 ping 事件({"type":"ping"})用于保持连接活跃,客户端可忽略。 | 流式响应示例 |
常见问题
在 Claude Desktop 或 Claude Code 中配置后,连接测试报错Model discovery — Gateway /v1/models returned HTTP 404,或请求地址出现/v1/v1/models,如何解决?
Claude Desktop、Claude Code 等客户端的模型发现(model discovery)功能会在配置的 base URL 后自动追加 /v1/models。请按以下两点排查:
- base URL 不要以
/v1/结尾:应填写到/apps/anthropic为止(例如华北2(北京)填https://dashscope.aliyuncs.com/apps/anthropic,其余地域的地址见上方“接入信息”)。若误填为.../apps/anthropic/v1/,客户端追加/v1/models后会形成/v1/v1/models的重复路径,导致 HTTP 404。因此出现 404 时,请先检查实际请求地址是否出现/v1/v1/重复,若有则去掉 base URL 末尾的/v1/。 - 手动添加模型以跳过自动发现:百炼 Anthropic 兼容端点仅提供 Messages 接口(
/v1/messages),不提供模型列表接口(/v1/models),因此模型发现请求本身也会返回 404。请在客户端的 Models 中手动添加模型(例如qwen3.7-plus)以跳过自动发现。