DEVELOPER DOCS

TOKENforu 接入教程

本教程面向开发者和团队,介绍如何获取 API Key、配置 OpenAI 兼容 Base URL,并在 curl、Python、Node.js 与常见客户端中接入 TOKENforu。

1. 快速开始

  1. 1)登录控制台:访问 https://api.tokenforu.cc/login 注册或登录账号。
  2. 2)获取 API Key:进入控制台后创建或复制你的 API Key。请妥善保存,不要公开到前端页面、GitHub 仓库或客户端安装包中。
  3. 3)配置 Base URL:在支持 OpenAI 兼容接口的 SDK 或客户端里填写 TOKENforu 的接口地址。
  4. 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_TOKENANTHROPIC_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,便于隔离权限和排查异常消耗。
  • 定期轮换密钥;人员离职、项目外包或密钥疑似泄露时应立即重置。
  • 上线前先做小流量测试,再逐步扩大并发。
  • 调用结果用于重要业务前,应增加人工复核、日志审计和异常兜底。