ProToken API

可用模型

目前支持以下 Claude 系列模型：

模型名称	系列	说明
claude-opus-4-6	Opus	最强模型，适合复杂推理和高难度任务
claude-opus-4-5-20251101	Opus	Opus 4.5 版本
claude-opus-4-20250514	Opus	Opus 4 版本
claude-opus-4-1-20250805	Opus	Opus 4.1 版本
claude-sonnet-4-6	Sonnet	均衡模型，性价比高，推荐日常使用
claude-sonnet-4-5-20250929	Sonnet	Sonnet 4.5 版本
claude-sonnet-4-20250514	Sonnet	Sonnet 4 版本
claude-3-7-sonnet-20250219	Sonnet	Sonnet 3.7 版本
claude-haiku-4-5-20251001	Haiku	轻量快速模型，适合简单任务和高频调用
claude-3-5-haiku-20241022	Haiku	Haiku 3.5 版本

API 对接

接口信息

Chat Completions (OpenAI 格式)

复制# POST https://api.protoken.ai/v1/chat/completions

curl https://api.protoken.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
        {"role": "user", "content": "你好"}
    ],
    "stream": true
  }'

Claude Messages 格式

复制# POST https://api.protoken.ai/v1/messages

curl https://api.protoken.ai/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "你好"}
    ]
  }'

支持的接口端点

端点	方法	说明
/v1/chat/completions	POST	聊天补全（OpenAI 格式）
/v1/completions	POST	文本补全（OpenAI 格式）
/v1/responses	POST	OpenAI Responses 格式
/v1/messages	POST	Claude Messages 格式
/v1/models	GET	获取可用模型列表
/v1/embeddings	POST	文本向量嵌入
/v1/images/generations	POST	图片生成
/v1/images/edits	POST	图片编辑
/v1/audio/transcriptions	POST	语音转文字
/v1/audio/translations	POST	语音翻译
/v1/audio/speech	POST	文字转语音
/v1/rerank	POST	重排序（Cohere/Jina）
/v1/moderations	POST	内容审核
/v1/realtime	WebSocket	实时对话（OpenAI Realtime）

请求头说明

Header	说明
Authorization	Bearer sk-你的密钥 (OpenAI 格式)
x-api-key	sk-你的密钥 (Claude 格式)
Content-Type	application/json

请求/响应格式

非流式响应示例

复制{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1713000000,
  "model": "claude-sonnet-4-6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么我可以帮你的吗？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式响应示例 (SSE)

复制data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"你好"}}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"！"}}]}

data: [DONE]

多模态输入（图片）

Claude 模型支持图片输入，可以发送图片让 AI 分析：

复制curl https://api.protoken.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "这张图片里有什么？"},
          {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
        ]
      }
    ]
  }'

思考模式 (Thinking/Reasoning)

部分 Claude 模型支持「思考模式」，模型会先进行推理再给出回答，适合复杂问题：

OpenAI 格式 - 使用模型名后缀

复制# 在模型名称后加 -thinking 后缀即可启用
curl https://api.protoken.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-7-sonnet-20250219-thinking",
    "messages": [{"role": "user", "content": "证明根号2是无理数"}]
  }'

Claude Messages 格式 - 使用 thinking 参数

复制curl https://api.protoken.ai/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 16000,
    "thinking": {
      "type": "enabled",
      "budget_tokens": 10000
    },
    "messages": [{"role": "user", "content": "证明根号2是无理数"}]
  }'

额度查询

使用 API Key 查询当前令牌的使用额度：

复制# 查询令牌额度
curl https://api.protoken.ai/api/usage/token/ \
  -H "Authorization: Bearer sk-你的密钥"

也可以登录 www.protoken.ai 后台，在「数据看板」和「令牌」页面查看详细用量。

聊天客户端对接

您可以使用以下客户端连接 ProToken API。登录后台后，在「聊天」页面可一键配置。

桌面端

客户端	平台	配置方式
Cherry Studio	Windows / Mac	设置 → 模型服务商 → 添加 → API 地址填 https://api.protoken.ai，填入 Key
AionUI	Windows / Mac	设置 → Provider → 添加 → 填入 API 地址和 Key

网页端（无需安装）

客户端	配置方式
Lobe Chat	打开网页 → 设置 → OpenAI → API 地址填 https://api.protoken.ai/v1，填入 Key
AI as Workspace	打开网页 → 设置 Provider → 类型选 OpenAI → 填入地址和 Key

移动端

客户端	平台	配置方式
OpenCat	iOS / Mac	设置 → 团队 → 域名填 https://api.protoken.ai，填入 Key
AMA 问天	iOS / Android	设置 → 服务器地址填 https://api.protoken.ai，填入 Key

开发者工具

工具	说明	配置方式
Claude Code	命令行 AI 编程助手	设置环境变量： ANTHROPIC_BASE_URL=https://api.protoken.ai ANTHROPIC_API_KEY=sk-你的密钥
CC Switch	Claude Code 多账号切换	按工具提示配置 API 地址和 Key
流畅阅读	浏览器翻译插件	插件设置 → 翻译服务 → 自定义 API → 填入地址和 Key

代码示例

Python (OpenAI SDK)

复制# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.protoken.ai/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "你好"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Python (Anthropic SDK)

复制# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    api_key="sk-你的密钥",
    base_url="https://api.protoken.ai"
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

print(message.content[0].text)

Node.js (OpenAI SDK)

复制// npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: 'sk-你的密钥',
    baseURL: 'https://api.protoken.ai/v1'
});

const response = await client.chat.completions.create({
    model: 'claude-sonnet-4-6',
    messages: [
        { role: 'user', content: '你好' }
    ],
    stream: true
});

for await (const chunk of response) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

cURL

复制curl https://api.protoken.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Claude Code (命令行)

如果你之前已登录过官方账号，需要先退出：

复制# 第一步：退出已有的官方登录（如未登录过可跳过）
claude /logout

设置环境变量并启动：

复制# 第二步：设置环境变量
export ANTHROPIC_BASE_URL=https://api.protoken.ai
export ANTHROPIC_API_KEY=sk-你的密钥

# 第三步：启动 Claude Code（可指定模型）
claude --model claude-opus-4-6

复制# 写入配置文件（永久生效）
echo 'export ANTHROPIC_BASE_URL=https://api.protoken.ai' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

后台功能

登录 www.protoken.ai 后，您可以使用以下功能：

Playground (在线测试)

无需写代码，直接在网页上测试 API 调用：

• 选择模型、调整参数（temperature、max_tokens 等）
• 发送消息并查看实时流式回复
• 查看完整的请求/响应数据（Debug 面板）
• 支持图片附件（多模态测试）
• 自定义请求体模式，适合高级用户调试

令牌管理 (API Key)

管理您的 API 密钥：

• 创建令牌 — 生成新的 sk-xxxx 格式 API Key
• 额度控制 — 为每个令牌设置独立的使用额度上限
• 模型限制 — 限制令牌可以访问哪些模型
• 过期时间 — 设置令牌有效期，过期自动失效
• 用量统计 — 查看每个令牌的使用情况

数据看板

可视化查看您的使用数据：

• 请求次数统计
• Token 消耗趋势
• 各模型使用分布
• 额度余额概览

使用日志

查看完整的 API 调用记录：

• 每次请求的模型、Token 数、耗时、状态
• 按时间、模型筛选和搜索
• 用于排查问题和分析用量

钱包管理

• 充值 — 支持多种支付方式（在线支付）
• 兑换码 — 输入兑换码获取额度
• 邀请奖励 — 通过邀请链接邀请好友，获得返利额度

个人设置

• 修改用户名、邮箱、密码
• 开启两步验证 (2FA) 增强账户安全
• 管理 Passkey 免密登录
• 查看/管理第三方登录绑定

聊天

内置聊天入口，点击即可一键跳转到 Cherry Studio、Lobe Chat 等客户端，自动填入您的 API Key 和服务器地址。

计费说明

额度概念

系统使用「额度」作为计费单位。每次 API 调用会根据消耗的 Token 数量扣除相应额度。

Token 计费

每次请求的费用由以下因素决定：

计费项	说明
输入 Token (Prompt)	您发送给模型的文本，包括系统提示词和对话历史
输出 Token (Completion)	模型生成的回复文本
缓存 Token (Cached)	命中提示词缓存的部分，享受折扣计费
图片输入	发送图片时，按图片大小折算 Token

不同模型的费率

不同模型有不同的计费倍率，一般规律：

模型系列	费率	说明
Opus	最高	最强能力，适合复杂任务
Sonnet	中等	性价比高，推荐日常使用
Haiku	最低	轻量快速，适合简单任务

提示词缓存 (Prompt Caching)

当多次请求包含相同的前缀内容时（如系统提示词），系统会自动缓存，后续请求的缓存命中部分按折扣价计费。

• 缓存命中的 Token 费用大幅降低
• 适合高频调用、固定系统提示词的场景
• 无需特殊设置，系统自动生效

获取额度

方式	说明
在线充值	后台「钱包管理」页面，支持多种支付方式
兑换码	后台「钱包管理」页面输入兑换码
邀请返利	分享邀请链接，好友注册后获得奖励额度
每日签到	每天签到可获得少量免费额度

错误码说明

HTTP 状态码	含义	解决方案
200	请求成功	-
400	请求参数错误	检查请求体 JSON 格式、必填字段（model、messages）是否正确
401	认证失败	检查 API Key 是否正确，是否已过期或被禁用
403	权限不足	当前令牌没有访问该模型的权限，请检查令牌的模型限制设置
429	请求过于频繁	已触发限流，请降低请求频率后重试
500	服务器内部错误	上游服务异常，请稍后重试
502/503	上游服务不可用	Claude 服务临时不可用，系统会自动重试，请稍后再试

错误响应格式

复制{
  "error": {
    "message": "具体错误信息",
    "type": "error_type",
    "code": "error_code"
  }
}

限流规则

为保证服务稳定，系统对请求频率有限制：

• 触发限流后返回 429 Too Many Requests
• 请在收到 429 后等待一段时间再重试
• 建议在代码中实现指数退避（exponential backoff）重试机制
• 具体限流阈值取决于您的账户等级和令牌配置

常见问题

Q: API 地址应该填什么？

大多数客户端填 https://api.protoken.ai 即可。如果客户端要求带 /v1 后缀，则填 https://api.protoken.ai/v1。具体看客户端的提示。

Q: 支持流式输出吗？

支持。请求时设置 "stream": true 即可。流式请求超时时间为 600 秒。

Q: 支持哪些 API 格式？

同时支持 OpenAI Chat Completions 格式和 Claude Messages 格式，您可以用 OpenAI SDK 或 Anthropic SDK 对接。

Q: 请求报 401 错误？

请检查 API Key 是否正确，格式为 sk-xxxx。确保在请求头中正确携带：OpenAI 格式用 Authorization: Bearer sk-xxxx，Claude 格式用 x-api-key: sk-xxxx。

Q: 请求报 429 限流？

说明请求过于频繁。请降低请求频率，建议在代码中加入重试间隔。如需更高配额，请联系管理员调整。

Q: 请求超时怎么办？

复杂问题可能需要较长处理时间。请将客户端超时设置为 300 秒以上。流式模式下建议设置 600 秒。

Q: 模型名称怎么填？

直接填模型 ID，如 claude-sonnet-4-6。完整模型列表请查看「可用模型」页面。也可以通过 GET /v1/models 接口获取当前可用模型列表。

Q: 如何查看额度和用量？

两种方式：1) 登录 www.protoken.ai 后台查看「数据看板」；2) 使用 API 查询 GET /api/usage/token/。

Q: 支持发送图片吗？

支持。Claude 模型支持多模态输入，可以在 messages 中通过 image_url 类型发送图片（URL 或 Base64）。详见「API 对接」页面的多模态输入部分。

Q: 在 Cursor 中如何配置？

打开 Cursor → Settings → Models → OpenAI API Key 填入 sk-你的密钥，Override OpenAI Base URL 填入 https://api.protoken.ai/v1，然后选择 Claude 模型即可。

Q: 在 VS Code 中如何使用？

安装 Continue、Cline 或其他 AI 插件，在插件设置中将 API 地址改为 https://api.protoken.ai/v1，填入 Key，选择模型即可。

Q: 后台的 Playground 是什么？

登录 www.protoken.ai 后台，点击「Playground」可以直接在网页上测试 API 调用，无需写代码，方便验证 Key 和模型是否正常工作。

Q: 可以用来写代码吗？

可以。推荐使用 Claude Code（命令行）、Cursor、VS Code + AI 插件、Cherry Studio 等工具，将 API 地址指向 https://api.protoken.ai 即可获得 Claude 的编程能力。