Claude 原生接口调用

说明Claude 系列模型支持通过官方原生接口调用，使用之前确保安装或升级 anthropic 依赖：

Copy

pip install -U anthropic

非 claude 模型请用 openai 的接口格式调用。

模型信息

模型名称	Claude Opus 4	Claude Sonnet 4	Claude Sonnet 3.7	Claude Sonnet 3.5	Claude Haiku 3.5	Claude Opus 3	Claude Haiku 3
是否支持扩展思考	是	是	是	否	否	否	否
上下文窗口大小	200K	200K	200K	200K	200K	200K	200K
最长输出长度	32000 tokens	64000 tokens	64000 tokens	8192 tokens	8192 tokens	4096 tokens	4096 tokens
训练数据截止时间	2025年3月	2025年3月	2024年11月	2024年4月	2024年7月	2023年8月	2023年8月

对于 3.5 及以上的模型，如果需要超过 4096 Tokens 的输出，请传入明确的 “max_tokens” 数值，参考上方表格中的最长输出长度。
对于 Sonnet 3.7，你可以通过在请求体中传入 extra_headers={"anthropic-beta": "output-128k-2025-02-19"} 来把最大输出从 64K 扩展到 128K，见下方「流式 128K」调用，或者参考 Claude 官方的Beta headers 说明。

Claude 4 新功能

新的拒绝停止原因 (Refusal Stop Reason)Claude 4 模型引入了新的 refusal 停止原因，用于处理模型因安全原因拒绝生成的内容：

Copy

{
  "id": "msg_014XEDjypDjFzgKVWdFUXxZP",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [{"type": "text", "text": "I would be happy to assist you. You can "}],
  "stop_reason": "refusal",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 564,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 22
  }
}

在迁移到 Claude 4 时，您应该更新应用程序以处理 refusal 停止原因。

扩展思考 (Extended Thinking)启用扩展思考后，Claude 4 模型的 Messages API 会返回 Claude 完整思考过程的摘要。摘要思考提供了扩展思考的全部智能优势，同时防止滥用。虽然 API 在 Claude 3.7 和 4 模型之间保持一致，但扩展思考的流式响应可能以”块状”传递模式返回，流式事件之间可能存在延迟。摘要由与您在请求中指定的模型不同的模型处理。思考模型不会看到摘要输出。

交错思考 (Interleaved Thinking)Claude 4 模型支持将工具使用与扩展思考交错，允许更自然的对话，其中工具使用和响应可以与常规消息混合。交错思考目前处于测试阶段。要启用交错思考，请在 API 请求中添加测试头 interleaved-thinking-2025-05-14：

Copy

extra_headers={
    "anthropic-beta": "interleaved-thinking-2025-05-14"
}

端点（Endpoint）： POST /v1/messages

调用

Curl

Python 非流式

Python 流式 128K

Python 交错思考

Copy

curl https://poloai.top \
     --header "x-api-key: $ANTHROPIC_API_KEY" \ # 换成你在 AiHubMix 生成的密钥
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

Body 请求结构

Copy

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
}

请求参数

名称	位置	类型	必选	说明
x-api-key	header	string	否	Bearer POLOAI_API_KEY
Content-Type	header	string	否	none
body	body	object	否	none
» model	body	string	是	none
» messages	body	[object]	是	none
»» role	body	string	否	none
»» content	body	string	是	none
» max_tokens	body	number	是	none

返回示例

Copy

200 Response

Copy

{
  "id": "msg_013Uf6CwwyjSe35n3yVaPbLM",
  "type": "message",
  "role": "assistant",
  "model": "claude-3-5-sonnet-20241022",
  "content": [
    {
      "type": "text",
      "text": "That's one of humanity's most enduring and complex philosophical questions! While there's no universal answer, I aim to explore such questions thoughtfully while acknowledging their complexity. I try to focus on having meaningful conversations and helping where I can. What does meaning in life mean to you?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 14,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 61
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

迁移到 Claude 4如果您正在从 Claude 3.7 迁移到 Claude 4 模型，请注意以下变化：

更新模型名称

Copy

# 从 Claude 3.7
model="claude-3-7-sonnet-20250219"

# 迁移到 Claude 4
model="claude-sonnet-4-20250514"  # 或 "claude-opus-4-20250514"

处理新的停止原因更新您的应用程序以处理新的 refusal 停止原因：

Copy

if response.stop_reason == "refusal":
    print("Claude 拒绝生成此内容")
elif response.stop_reason == "end_turn":
    print("正常完成")

移除不支持的功能

Token 高效工具使用：仅在 Claude Sonnet 3.7 中可用，Claude 4 中不再支持
扩展输出：output-128k-2025-02-19 测试头仅在 Claude Sonnet 3.7 中可用

如果您正在从 Claude Sonnet 3.7 迁移，建议从请求中移除这些测试头：

Copy

# 移除这些头部（如果存在）
# "token-efficient-tools-2025-02-19"
# "output-128k-2025-02-19"

在应用中使用（以 Lobe-Chat 为例）

进入设置页面选择模型服务商 Claude
API key 输入本站的 Key
接口代理地址，直接输入下方的网址：

Copy

https://poloai.top

建议打开「使用客户端请求模式」
最后在模型列表添加自己要使用的模型（建议从我们网站的设置页面复制粘贴模型名后选择）