API 参考

API 文档

将 Claude Max 集成到应用程序所需的一切。完整的端点、6 种语言的代码示例和所有 5 个模型。

身份验证

基础 URL

生产环境
https://claudemaxhub.com/api/v1

所有 API 请求必须使用 HTTPS。

API 密钥头

头部
Authorization: Bearer YOUR_API_KEY

试用激活后将提供您的 API 密钥。请在每个请求中包含它。

速率限制

每分钟 60 个请求

内容类型

application/json

响应格式

JSON (UTF-8)

获取 API 密钥

注册免费试用 → 激活账户 → 在控制面板中找到 API 密钥。

可用模型

包含所有模型 — 选择适合您用例的模型。

模型 API ID 上下文窗口 最适合
Claude Opus 5 claude-opus-5 200K 复杂推理、研究、编程
Claude Fable 5 claude-fable-5 1M 长文档、大型代码库
Claude Opus 4 claude-opus-4-8 200K 分析、详细报告
Claude Sonnet 4 claude-sonnet-4 200K 通用、聊天、写作
Claude Haiku claude-haiku 200K 快速任务、实时响应
GET /api/v1/models 返回您账户可用的所有 Claude 模型列表。
cURL
curl https://claudemaxhub.com/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import requests

response = requests.get(
    "https://claudemaxhub.com/api/v1/models",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

models = response.json()
for model in models["data"]:
    print(f"{model['id']}: {model['description']}")
JavaScript
const response = await fetch(
  'https://claudemaxhub.com/api/v1/models',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
  }
);

const { data } = await response.json();
data.forEach(model => console.log(model.id));
PHP
$ch = curl_init('https://claudemaxhub.com/api/v1/models');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$models = json_decode($response, true);
foreach ($models['data'] as $model) {
    echo $model['id'] . ': ' . $model['description'] . "\n";
}
Go
req, _ := http.NewRequest("GET",
  "https://claudemaxhub.com/api/v1/models", nil)

req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

var result struct {
    Data []struct {
        ID          string `json:"id"`
        Description string `json:"description"`
    } `json:"data"`
}
json.NewDecoder(resp.Body).Decode(&result)

for _, m := range result.Data {
    fmt.Printf("%s: %s\n", m.ID, m.Description)
}
Ruby
require 'net/http'
require 'json'

uri = URI('https://claudemaxhub.com/api/v1/models')
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer YOUR_API_KEY'

res = Net::HTTP.start(uri.hostname, uri.port,
  use_ssl: true) { |http| http.request(req) }

models = JSON.parse(res.body)
models['data'].each do |m|
  puts "#{m['id']}: #{m['description']}"
end
200 — Success
{
  "data": [
    {"id": "claude-opus-5",   "description": "最强大 — 高级推理与复杂分析",   "context_window": 200000},
    {"id": "claude-fable-5",  "description": "旗舰模型 — 100万令牌上下文窗口",  "context_window": 1000000},
    {"id": "claude-opus-4-8",   "description": "深度分析与复杂多步骤任务",   "context_window": 200000},
    {"id": "claude-sonnet-4", "description": "速度与质量的最佳平衡", "context_window": 200000},
    {"id": "claude-haiku",    "description": "最快响应 — 适合实时应用",    "context_window": 200000}
  ]
}
创建聊天
POST /api/v1/chat 向 Claude 模型发送消息并接收响应。这是所有交互的核心端点。
model 必填
string
用于生成响应的模型。
messages 必填
array
包含角色和内容的消息对象数组。
max_tokens
integer
响应中的最大令牌数。
temperature
float
控制随机性。0 = 确定性,1 = 创造性。
stream
boolean
启用流式响应。
cURL
curl -X POST https://claudemaxhub.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'
Python
import requests

response = requests.post(
    "https://claudemaxhub.com/api/v1/chat",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5",
        "messages": [
            {"role": "user", "content": "Explain quantum computing in simple terms."}
        ],
        "max_tokens": 1024,
        "temperature": 0.7,
    },
)

data = response.json()
print(data["content"][0]["text"])
JavaScript (Node.js / Fetch)
const response = await fetch('https://claudemaxhub.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'claude-opus-5',
    messages: [
      { role: 'user', content: 'Explain quantum computing in simple terms.' },
    ],
    max_tokens: 1024,
    temperature: 0.7,
  }),
});

const data = await response.json();
console.log(data.content[0].text);
PHP (cURL)
$ch = curl_init('https://claudemaxhub.com/api/v1/chat');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model'       => 'claude-opus-5',
        'messages'    => [
            ['role' => 'user', 'content' => 'Explain quantum computing in simple terms.'],
        ],
        'max_tokens'  => 1024,
        'temperature' => 0.7,
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['content'][0]['text'];
Go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "io"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "model": "claude-opus-5",
        "messages": []map[string]string{
            {"role": "user", "content": "Explain quantum computing in simple terms."},
        },
        "max_tokens":  1024,
        "temperature": 0.7,
    })

    req, _ := http.NewRequest("POST",
        "https://claudemaxhub.com/api/v1/chat",
        bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
Ruby
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://claudemaxhub.com/api/v1/chat')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  model: 'claude-opus-5',
  messages: [
    { role: 'user', content: 'Explain quantum computing in simple terms.' }
  ],
  max_tokens: 1024,
  temperature: 0.7
}.to_json

response = http.request(request)
data = JSON.parse(response.body)
puts data['content'][0]['text']
200 — 成功响应
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [
    {
      "type": "text",
      "text": "Quantum computing uses quantum bits (qubits) that can exist in multiple states simultaneously..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 128
  }
}
id
string
唯一消息标识符
model
string
用于响应的模型
content
array
内容块数组(文本)
stop_reason
string
模型停止原因:end_turn、max_tokens
usage
object
令牌使用统计
错误处理

所有可能的错误响应及处理方法。

HTTP 状态 描述 解决方案
401 无效或缺失的 API 密钥 在控制面板中检查您的 API 密钥
403 账户未激活或试用已过期 激活账户或续订订阅
404 无效的端点或未找到模型 检查 URL 和模型名称
422 无效的请求参数 检查请求体格式
429 超出速率限制 等待后重试,或降低请求频率
500 内部服务器错误 几秒后重试

准备好使用 Claude Max 构建了吗?

获取 30 天试用的免费 API 密钥。包含所有 5 个模型,无需信用卡。