跳转到主要内容
Claude API 使用 https://wisdom-gate.juheapi.com 作为base url，提供对 Claude 模型的程序化访问。主要的 API 是用于对话交互的 Messages API (POST /v1/messages)。
刚接触 Claude？ 请从 开始使用 获取先决条件和您的第一个 API 调用，或者查看 使用 Messages 了解请求/响应模式和示例。

​
先决条件

要使用 Claude API，您需要： 有关分步设置说明，请参阅 开始使用。

​
可用 API

Claude API 包含以下 API： 正式版 (General Availability):
  • Messages API: 向 Claude 发送消息进行对话交互 (POST /v1/messages)
  • Message Batches API: 异步处理大量 Messages 请求，成本降低 50% (POST /v1/messages/batches)
  • Token Counting API: 在发送前计算消息中的 token 以管理成本和速率限制 (POST /v1/messages/count_tokens)
  • Models API: 列出可用的 Claude 模型及其详细信息 (GET /v1/models)
Beta 版:
  • Files API: 上传和管理用于跨多个 API 调用的文件 (POST /v1/files, GET /v1/files)
  • Skills API: 创建和管理自定义智能体技能 (POST /v1/skills, GET /v1/skills)
有关包含所有端点、参数和响应模式的完整 API 参考，请浏览导航中列出的 API 参考页面。要访问 Beta 功能，请参阅 Beta headers。

​
认证

所有对 Claude API 的请求都必须包含以下标头：
标头值必填
AuthorizationBearer $WISDOM_GATE_KEY是
content-typeapplication/json是
如果使用 客户端 SDK，SDK 将自动发送这些标头。有关 API 版本控制的详细信息，请参阅 API 版本。

​
获取 API 密钥

API 通过网页 控制台 提供。您可以在 账户设置 中生成 API 密钥。有关速率限制，请参阅 控制支出。

​
客户端 SDK

Anthropic 提供了官方 SDK，通过处理认证、请求格式化、错误处理等来简化 API 集成。 优势:
  • 自动标头管理 (x-api-key, anthropic-version, content-type)
  • 类型安全的请求和响应处理
  • 内置重试逻辑和错误处理
  • 流式传输支持
  • 请求超时和连接管理
示例 (Python): 
from anthropic import Anthropic

client = Anthropic(
    base_url="https://wisdom-gate.juheapi.com",
    api_key="WISDOM_GATE_KEY"
)

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}]
)
有关客户端 SDK 及其各自安装说明的列表，请参阅 客户端 SDK。

​
Claude API 与第三方平台

Claude 可通过 Anthropic 的直接 API 和合作伙伴平台使用。根据您的基础设施、合规性要求和定价偏好进行选择。

​
Claude API

  • 首先 直接访问 最新模型和功能
  • Anthropic 计费和支持
  • 最适合: 新集成、全功能访问、与 Anthropic 的直接关系

​
第三方平台 API

通过 Wisdom Gate 访问 Claude:
  • 与云提供商计费和 IAM 集成
  • 可能存在 功能延迟 或与直接 API 的差异
  • 最适合: 现有云承诺、特定合规性要求、统一云计费
平台提供商文档
Amazon BedrockAWSClaude on Amazon Bedrock
Vertex AIGoogle CloudClaude on Vertex AI
Azure AIMicrosoft AzureClaude on Azure AI
有关跨平台功能可用性的信息，请参阅 功能概览。

​
请求和响应格式

​
请求大小限制

API 对不同的端点有不同的最大请求大小限制：
端点最大大小
标准端点 (Messages, Token Counting)32 MB
Batch API256 MB
Files API500 MB
如果您超过这些限制，您将收到 413 request_too_large 错误。

​
响应标头

Claude API 在每个响应中包含以下标头：
  • request-id: 请求的全局唯一标识符
  • anthropic-organization-id: 与请求中使用的 API 密钥关联的组织 ID

​
速率限制和可用性

​
速率限制

API 强制执行速率限制和支出限制，以防止滥用并管理容量。限制分为使用等级，随着您使用 API 自动增加。每个等级都有：
  • 支出限制: API 使用的每月最大成本
  • 速率限制: 每分钟最大请求数 (RPM) 和每分钟 token 数 (TPM)
您可以在 控制台 中查看您组织的当前限制。如需更高的限制或优先等级（具有承诺支出的增强服务级别），请通过控制台联系销售。 有关限制、等级和用于速率限制的令牌桶算法的详细信息，请参阅 速率限制。

​
可用性

Claude API 在全球 许多国家和地区 均可用。请查看支持的地区页面以确认您所在位置的可用性。

​
基本示例

这是一个使用 Messages API 的最小请求示例： 
curl https://wisdom-gate.juheapi.com/v1/messages \
  --header "Authorization: Bearer $WISDOM_GATE_KEY" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'
响应: 
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I assist you today?"
    }
  ],
  "model": "claude-sonnet-4-5-20250929",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}
有关完整示例和教程，请参阅 开始使用 和 使用 Messages。

​
下一步

开始使用

先决条件、分步教程和多语言示例

使用 Messages

请求/响应模式、多轮对话和最佳实践

Messages API 参考

完整的 API 规范：参数、响应和错误代码

客户端 SDK

Python, TypeScript, Java, Go, C#, Ruby, and PHP 的安装指南

功能概览

探索功能：缓存、视觉、工具使用、流式传输等

速率限制

使用等级、支出限制和基于令牌桶算法的速率限制