BoboToken 使用指南

站点定位

• 统一入口：一个 API 地址，兼容多模型调用。
• 人民币结算：支持对公采购与财务流程。
• 工程交付：文档、定价、模型广场、控制台形成完整闭环。

快速开始

1. 注册并登录控制台。
2. 完成套餐购买或余额充值。
3. 签发 API Key，替换项目中的 base_url 与 api_key。

常见问题

为什么模型广场和定价页分开？

模型广场用于“选模型”，定价页用于“看价格和购买策略”，两者分工不同，能减少信息混杂。

同一个账户可以创建多个 Key 吗？

可以。建议按项目和团队拆分 Key，便于审计与成本归集。

什么时候会扣费？

调用模型时按实际用量扣费，具体以定价页和控制台账单为准。

Python 环境安装

如果你用 Python SDK，建议 Python 3.10+。

Windows

winget install Python.Python.3.12

macOS

brew install python@3.12

Linux

sudo apt update
sudo apt install -y python3 python3-pip python3-venv

Node.js 环境安装

如果你用 Node.js 或 TypeScript SDK，建议 Node.js 18+。

Windows

choco install nodejs-lts

macOS

brew install node

Linux

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Claude Code 快速开始指南

1. 在控制台创建 API Key。
2. 在 Claude Code 里选择 OpenAI Compatible 模式。
3. 将 Base URL 配置为 https://api.bobotoken.top/v1。
4. 发起一条最小请求验证连通性。

{
  "model": "claude-sonnet-4",
  "messages": [{"role": "user", "content": "hello"}]
}

Codex 快速开始指南

1. 准备 API Key。
2. Endpoint 指向 https://api.bobotoken.top/v1。
3. 先从 gpt-4.1-mini 验证，再按业务切换模型。
4. 验证聊天请求与代码请求各一条。

curl https://api.bobotoken.top/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [{"role": "user", "content": "write hello world"}]
  }'

OpenClaw 快速开始指南

1. 在 OpenClaw 新增 OpenAI 兼容提供商。
2. 填入 API Key 与 Base URL。
3. 选择模型（如 gpt/claude/gemini 系列）。
4. 执行测试会话并观察响应时延与稳定性。

VS Code 图形化操作教程

1. 打开扩展设置，进入模型提供商配置页面。
2. 新增 OpenAI 兼容端点并填入 Key。
3. 保存后在模型下拉框选择目标模型。
4. 先做问答测试，再做代码补全与重构测试。

Claude Code 与 Codex 协同开发

• Claude Code 负责需求分析、方案推演、风险梳理。
• Codex 负责代码改动、命令执行、验证与收敛。
• 两者可共用同一平台账户，统一计费与审计。

推荐全局规则

• 默认超时建议 60-120 秒。
• 对 429/5xx 启用指数退避重试。
• 生产环境固定模型版本，不依赖不稳定别名。
• 记录 request id、model、tokens、耗时用于排障。
• API Key 通过环境变量注入，不写入仓库。