1. 快速开始
- 1)登录控制台:访问 https://api.tokenforu.cc/login 注册或登录账号。
- 2)获取 API Key:进入控制台后创建或复制你的 API Key。请妥善保存,不要公开到前端页面、GitHub 仓库或客户端安装包中。
- 3)配置 Base URL:在支持 OpenAI 兼容接口的 SDK 或客户端里填写 TOKENforu 的接口地址。
- 4)发起第一次请求:使用 curl、Python 或 Node.js 示例测试连通性,再接入你的业务系统。
2. API 基础信息
TOKENforu 主要提供 OpenAI 兼容接口。不同模型、渠道和套餐以控制台实际展示为准。
控制台:https://api.tokenforu.cc/login
推荐 Base URL:https://api.tokenforu.cc/v1
认证方式:Authorization: Bearer YOUR_TOKENFORU_API_KEY
如果控制台展示的接口地址与你本页不同,请以控制台最新显示为准。
3. 代码示例
curl
curl https://api.tokenforu.cc/v1/chat/completions \
-H "Authorization: Bearer YOUR_TOKENFORU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "你好,TOKENforu"}
]
}'
Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="YOUR_TOKENFORU_API_KEY",
base_url="https://api.tokenforu.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好,TOKENforu"}]
)
print(response.choices[0].message.content)
Node.js(OpenAI SDK)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_TOKENFORU_API_KEY",
baseURL: "https://api.tokenforu.cc/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好,TOKENforu" }],
});
console.log(response.choices[0].message.content);
流式输出
stream = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "请用三句话介绍 TOKENforu"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="")
4. Claude Code 安装配置
Claude Code 是面向终端和开发环境的 AI 编程工具。以下为 TOKENforu 的通用配置思路,适用于支持自定义 API Key 和 Base URL 的版本;不同版本的命令、变量名和配置项可能略有差异,请以 Claude Code 当前版本为准。
安装
npm install -g @anthropic-ai/claude-code
claude --version
如果官方安装方式发生变化,请优先参考 Claude Code 官方文档。
配置 TOKENforu
Claude Code 通常使用 Anthropic/Claude 接口。请在 TOKENforu 控制台确认 Claude 相关模型和接入地址;如果控制台有专门的 Claude / Anthropic Base URL,请以控制台展示为准。
# 示例:具体变量名以 Claude Code 当前版本为准
export ANTHROPIC_API_KEY="YOUR_TOKENFORU_API_KEY"
export ANTHROPIC_BASE_URL="https://api.tokenforu.cc"
如果你的版本使用 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_URL 或其他变量名,请将值替换为 TOKENforu 的 API Key 和控制台展示的接入地址。
验证
claude
# 在交互中输入:用一句话介绍 TOKENforu
如果出现鉴权失败、模型不存在或上游错误,请先检查 API Key、Base URL、模型权限和账户余额。
5. Codex 安装配置
Codex 类工具通常使用 OpenAI 兼容接口,因此可以直接配置 TOKENforu 的 API Key 和 OpenAI 兼容 Base URL。
安装
npm install -g @openai/codex
codex --version
如官方安装方式或包名发生变化,请以 Codex 当前官方文档为准。
配置 TOKENforu
export OPENAI_API_KEY="YOUR_TOKENFORU_API_KEY"
export OPENAI_BASE_URL="https://api.tokenforu.cc/v1"
# 如果你的工具使用 OPENAI_API_BASE,请填同样的地址
export OPENAI_API_BASE="https://api.tokenforu.cc/v1"
模型名称请以 TOKENforu 控制台可用模型为准。若工具支持在配置文件中填写 Base URL,也可以将 https://api.tokenforu.cc/v1 写入配置文件。
验证
codex "用一句话介绍 TOKENforu"
如果命令格式与你安装的版本不同,请进入 Codex 交互模式后输入同样的测试问题。
6. 客户端配置
凡支持 OpenAI 兼容接口的客户端,通常可以按以下方式配置。不同客户端字段名称略有差异,但核心配置一致。
Provider / 服务商:OpenAI Compatible / 自定义 OpenAI
API Key:你的 TOKENforu API Key
Base URL:https://api.tokenforu.cc/v1
Model:以控制台可用模型为准,例如 gpt-4o-mini
常见可尝试的客户端包括 Chatbox、Cherry Studio、Open WebUI、LobeChat、NextChat 等。若客户端要求填写完整接口路径,请优先填写 Base URL;不要重复追加 /v1。
7. 余额与用量
余额、套餐、赠送额度、模型倍率和活动规则以 TOKENforu 控制台展示为准。建议在业务接入前先完成小额测试,确认模型、响应速度和计费记录符合预期。
- •在控制台查看余额、套餐和调用记录。
- •不同模型可能有不同倍率、价格或可用渠道。
- •高频调用前建议设置合理的用户并发、项目隔离和预算监控。
8. 常见错误
401 Unauthorized
API Key 缺失、格式错误或已失效。请检查 Authorization Header 是否为 Bearer 格式。
403 Forbidden
账号、分组、模型或渠道权限不足。请检查控制台配置。
429 Too Many Requests
请求过快、并发过高、额度不足或上游限流。请降低并发或稍后重试。
模型不存在
模型名称填写错误,或当前账号没有对应模型权限。请以控制台模型列表为准。
流式响应中断
可能由客户端超时、网络波动、上游中断或内容过长导致。建议开启重试,并检查客户端超时设置。
9. 安全建议
- •不要在浏览器前端、移动端安装包或公开仓库中暴露 API Key。
- •不同项目使用不同 API Key,便于隔离权限和排查异常消耗。
- •定期轮换密钥;人员离职、项目外包或密钥疑似泄露时应立即重置。
- •上线前先做小流量测试,再逐步扩大并发。
- •调用结果用于重要业务前,应增加人工复核、日志审计和异常兜底。