Anthropic SDK

概述

TopRouter 为您提供稳定、高效的 Anthropic SDK 访问服务，让您能够无缝集成 Claude 的强大 AI 能力到您的应用中。

获取 API 密钥

开始使用前，您需要获取 TopRouter 的 API 密钥：

访问 TopRouter 官网并完成注册
登录后点击页面右上角的用户菜单，选择"密钥管理"
点击"生成新密钥"按钮，复制生成的 API 密钥

安全提示

请妥善保管您的 API 密钥，切勿在公共代码仓库、前端代码或任何公开场合暴露。建议使用环境变量的方式进行管理。

功能特性

TopRouter 完全兼容 Anthropic SDK 标准，支持以下核心功能：

消息对话（Messages API）：支持 Claude 全系列模型进行对话交互
流式输出（Streaming）：实时获取模型响应
扩展思考（Extended Thinking）：支持深度推理模式
工具调用（Tool Use）：让模型调用自定义函数

更多关于请求参数和响应格式的详细信息，请参阅 Anthropic 官方文档。

快速开始

TopRouter 完全兼容 Anthropic 官方客户端库。如果您已经在使用 Anthropic SDK，只需修改两处配置即可无缝迁移：

将 API Key 替换为 TopRouter 的密钥
将 Base URL 设置为 TopRouter 的服务地址

Python 集成示例

首先安装 Anthropic Python 库：

# Requirements: Python 3.8+
pip install anthropic

然后使用以下代码调用 API：

import os
from anthropic import Anthropic

# 初始化客户端
client = Anthropic(
    api_key=os.environ.get("TOPROUTER_API_KEY"),  # 从环境变量读取密钥
    base_url="https://api.toprouter.ai/api/anthropic",  # TopRouter 服务地址
)

# 发起消息请求
message = client.messages.create(
    model="tp.claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)

# 输出模型回复
print(message.content)

TypeScript/Node.js 集成示例

首先安装 Anthropic TypeScript 库：

npm install @anthropic-ai/sdk
# 或使用 yarn
yarn add @anthropic-ai/sdk

然后使用以下代码调用 API：

import Anthropic from '@anthropic-ai/sdk';

// 初始化客户端
const client = new Anthropic({
  apiKey: process.env.TOPROUTER_API_KEY,  // 从环境变量读取密钥
  baseURL: 'https://api.toprouter.ai/api/anthropic',  // TopRouter 服务地址
});

// 发起消息请求
async function chat() {
  const message = await client.messages.create({
    model: 'tp.claude-sonnet-4-5-20250929',
    max_tokens: 1024,
    messages: [{ role: 'user', content: 'Hello, Claude' }],
  });
  
  console.log(message.content);
}

chat();

cURL 示例

curl https://api.toprouter.ai/api/anthropic/v1/messages \
  --header "x-api-key: $TOPROUTER_API_KEY" \
  --header "content-type: application/json" \
  --data \
'{
  "model": "tp.claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "Hello, Claude"}
  ]
}'

环境变量配置

为了安全管理 API 密钥，建议使用环境变量：

Linux/macOS：

export TOPROUTER_API_KEY="your-api-key-here"

Windows PowerShell：

$env:TOPROUTER_API_KEY="your-api-key-here"

使用 .env 文件（推荐）：

在项目根目录创建 .env 文件：

TOPROUTER_API_KEY=your-api-key-here

然后使用 python-dotenv（Python）或 dotenv（Node.js）加载环境变量。

下一步

查看快速入门指南了解更多使用场景
探索函数调用功能实现更复杂的交互
了解提示词缓存优化 API 调用成本

概述​

获取 API 密钥​

功能特性​

快速开始​

Python 集成示例​

TypeScript/Node.js 集成示例​

cURL 示例​

环境变量配置​

下一步​

概述