文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯混元大模型>腾讯混元大模型 兼容接口>混元 Anthropic API 兼容接口相关调用示例

混元 Anthropic API 兼容接口相关调用示例

最近更新时间：2026-01-07 14:29:31

我的收藏

本页目录：

混元 API 兼容了 Anthropic 的接口规范，这意味着您可以直接使用 Anthropic 官方提供的 SDK 来调用混元大模型。您仅需要将 base_url 和 api_key 替换成混元的相关配置，不需要对应用做额外修改，即可无缝将您的应用切换到混元大模型。
base_url：https://api.hunyuan.cloud.tencent.com/anthropic
api_key：需在控制台 API Key 页面进行创建，操作步骤请参考 API Key 管理。
接口请求地址完整路径：https://api.hunyuan.cloud.tencent.com/anthropic/v1/messages

支持模型

hunyuan-2.0-thinking-20251109
hunyuan-2.0-instruct-20251111

通过 Claude Code 接入使用

安装 Claude Code

安装或更新 Anthropic Claude Code，运行以下命令：
npm install -g @anthropic-ai/claude-code

编辑配置文件

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hunyuan.cloud.tencent.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "${API_KEY}",
    "ANTHROPIC_CUSTOM_HEADERS": "",
    "ANTHROPIC_MODEL": "${MODEL_NAME}",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "${MODEL_NAME}",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "${MODEL_NAME}",
    "ANTHROPIC_SMALL_FAST_MODEL": "${MODEL_NAME}"
  }
}

执行 Claude 命令

进入项目目录，执行 Claude 命令，即可开始使用。




通过 Anthropic SDK 接入使用

安装 SDK

安装或更新 Anthropic Python SDK，运行以下命令：
pip install anthropic

示例代码片段

Python
cURL
import anthropic

client = anthropic.Anthropic(
    api_key=os.getenv("API_KEY"),
    base_url="https://api.hunyuan.cloud.tencent.com/anthropic",
)

message = client.messages.create(
    model="hunyuan-2.0-thinking-20251109",
    system="You are a helpful assistant.",
    max_tokens=16000,
    thinking={
        "type": "enabled"
    },
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Hi, how are you?"
                }
            ]
        }
    ]
)
print(message.content)
curl https://api.hunyuan.cloud.tencent.com/anthropic/v1/messages \\
-H "Content-Type: application/json" \\
-H "x-api-key: sk-xxxxxxxx" \\
-d '{
    "model": "hunyuan-2.0-thinking-20251109",
    "max_tokens": 16000,
    "stream": true,
    "system": [
        {
            "type": "text",
            "text": "You are a helpful assistant."
        }
    ],
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Hi, how are you?"
                }
            ]
        }
    ]
}'

Anthropic API 兼容性详情

HTTP Headers

参数名
类型
是否必选
说明
content-type
string
是
application/json
x-api-key
string
是
用于身份验证
anthropic-beta
string
否
不处理此头部

请求字段

参数名
类型
是否必选
说明
model
string
是
模型
max_tokens
int
否
最大输出 token 数
messages
list
是
消息列表
message[n].role
string
是
角色，支持'user'或'assistant'
message[n].content
string 或 list
是
当类型为 string 时，表示具体的正文内容
message[n].content[m].type
string
是
内容类型，当前支持 text、thinking、tool_use、tool_result
当content type 为 text时，使用以下字段
message[n].content[m].text
string
是
正文内容
当content type 为 thinking时，使用以下字段
message[n].content[m].thinking
string
是
思考内容
message[n].content[m].signature
string
否
思考内容签名
当content type为 tool_use时，使用以下字段
message[n].content[m].id
string
是
工具使用 id
message[n].content[m].name
string
是
工具名称
message[n].content[m].input
map
是
工具输入参数
当content type 为tool_result时，使用以下字段
message[n].content[m].tool_use_id
string
是
工具使用 id
message[n].content[m].content
string
是
工具调用结果
message[n].content[m].is_error
bool
否
工具调用是否失败
metadata
object
否
元信息
metadata.user_id
string
否
用户信息
service_tier
string
否
-
stop_sequences
string list
否
模型遇到这些序列时会停止生成
stream
bool
否
是否开启流式
system
string 或 list
否
system prompt
system[n].type
string
是
system prompt 内容类型，当前支持 text
当 system type 为 text 时，使用以下字段
system[n].text
string
是
system prompt 具体内容
temperature
float
否
超参数
top_k
int
否
超参数
top_p
float
否
超参数
thinking
object
否
思考配置
thinking.type
string
否
当前支持 enabled 或 disabled
thinking.budget_tokens
int
否
思考过程最大 tokens
tools
list
否
工具列表
tools[n].name
string
是
工具名称
tools[n].description
string
否
工具描述
tools[n].input_schema
json
否
工具输入格式
tool_choice
string
否
可选值为 auto、any、tool 和 none

响应字段

流式响应

当前流式响应支持的事件为：
message_start
message_delta
message_stop
content_block_start
content_block_delta
content_block_stop

当流式事件类型为 message_start、message_delta和message_stop 时，响应内容如下：
参数名
类型
说明
type
string
数据类型
当type为message_start时，使用以下字段
message
object
消息
message.id
string
唯一的响应 id
message.model
string
模型
message.type
string
类型，固定值为 message
message.role
string
角色，固定值为 assistant
message.content
list
内容，固定为 []
message.stop_reason
string
停止原因，固定为空
message.stop_sequence
string list
停止序列，固定为空
message.usage
object
token 消耗
message.usage.input_tokens
int
输入 tokens
message.usage.output_tokens
int
输出 tokens
message.usage.service_tier
string
-
当type为message_delta时，使用以下字段
delta
object
追加信息
delta.stop_reason
string
停止原因，可能值为 end_turn、max_tokens、stop_sequence、tool_use、sensitive
delta.stop_sequence
string list
停止序列
usage
object
token 消耗
usage.input_tokens
int
输入tokens
usage.output_tokens
int
输出tokens
当type为message_stop时，无其他字段

当流式事件类型为 content_block_start、content_block_delta和content_block_stop 时，响应内容如下：
参数名
类型
说明
type
string
数据类型
index
int
当前内容在内容数组中的位置
当type为content_block_start时，使用以下字段
content_block
object
内容数据
content_block.type
string
内容类型，可能值为 text、thinking、tool_use 和 tool_result
当content_block type 为 text时，使用以下字段
content_block.text
string
正文内容，固定为空
当content_block type 为 thinking时，使用以下字段
content_block.thinking
string
思考内容，固定为空
content_block.signature
string
思考内容签名，固定为空
当content_block type为 tool_use时，使用以下字段
content_block.id
string
工具使用id
content_block.name
string
工具名称
content_block.input
map
工具输入参数
当type为content_block_delta时，使用以下字段
delta.type
string
数据类型，可能值为 thinking_delta、text_delta、input_json_delta
当 delta type为 thinking_delta时，使用以下字段
delta.thinking
string
思考内容
当 delta type为 text_delta时，使用以下字段
delta.text
string
正文内容
当 delta type为 input_json_delta时，使用以下字段
delta.partial_json
string
部分输入 JSON 内容
当type 为content_block_stop时，无其他字段

非流式响应

非流式响应的格式为application/json，body 字段如下：
参数名
类型
说明
id
string
唯一的响应 id
model
string
请求的模型
role
string
角色，固定为 assistant
type
string
固定为 message
content
list
内容数组
content[n].type
string
内容类型，可能值为 text、thinking、tool_use
当content type 为 text时，使用以下字段
content[n].text
string
正文内容
当content type 为 thinking时，使用以下字段
content[n].thinking
string
思考内容
content[n].signature
string
思考内容签名
当content type为 tool_use时，使用以下字段
content[n].id
string
工具使用 id
content[n].name
string
工具名称
content[n].input
map
工具输入参数
stop_reason
string
停止原因，可能值为 end_turn、max_tokens、stop_sequence、tool_use、sensitive
stop_sequence
string
停止序列
usage
object
-
usage.input_tokens
int
输入 tokens
usage.output_tokens
int
输出 tokens
usage.service_tier
string
-
中国站
目录