开始使用

BetterToken 文档：API 接入与 AI 编程工具配置

BetterToken 中文文档：使用 API Key 和正确的 Base URL，将 Claude、GPT 接入编程工具与自有应用，查看 SDK 示例、用量管理与错误排查。

BetterToken 是面向全球开发者与团队的 AI 模型 API 网关，通过 Anthropic 和 OpenAI 兼容 API，将编程工具与自有代码接入可用模型。使用一个 BetterToken API Key、客户端协议对应的 Base URL，以及模型广场中的 Model ID，即可开始调用。

从这里开始

快速接入

注册账号、充值并获取 BetterToken API Key。

支持的工具

查找命令行工具、编辑器、桌面应用或自动化平台的配置指南。

API 参考

选择接口，查看请求和响应格式。

选择接入方式

创建 API Key 后，按任务选择对应入口。发送请求前，复制准确的 Model ID。

你的任务	协议	Base URL	入门文档
在终端中使用 Claude Code	Anthropic Messages	`https://bettertoken.ai`	Claude Code 配置
使用 Codex CLI 或 Codex App 执行本地任务	OpenAI 兼容，Responses	`https://bettertoken.ai/v1`	Codex CLI / App 配置
接入 Cursor 或其他外部工具	以对应指南中的 OpenAI 兼容配置为准	`https://bettertoken.ai/v1`	Cursor 配置或全部工具
在自有代码中调用模型	OpenAI 兼容或 Anthropic Messages	OpenAI：`https://bettertoken.ai/v1`；Anthropic：`https://bettertoken.ai`	Python、JavaScript 与 curl 示例
通过 OpenAI Images 生成或编辑图片	OpenAI 兼容，Images	`https://bettertoken.ai/v1`	GPT Image 指南或 Nano Banana 指南

外部工具的 URL 字段请按工具总览填写。部分字段需要完整的请求 URL。

常用指南

指南	可以完成的任务
Claude Code	安装客户端，设置认证和模型映射，并验证会话
Codex CLI / App	配置 `config.toml` 和 `auth.json`，使用 API Key 进行本地访问
GPT Image	生成图片、上传参考图进行编辑，并保存结果
Nano Banana	选择图片工作流，检查返回图片的尺寸
模型更新	阅读模型公告，再到模型广场确认当前可用情况
常见问题	解决账户、协议、模型和工具配置问题

BetterToken 如何工作

客户端将模型请求发送到 BetterToken。BetterToken 接入多个供应商，并在上游服务之间动态路由；你可以在同一个控制台管理 API Key、余额和请求记录。

API 类型	Base URL	认证方式	文本接口
OpenAI 兼容	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Chat Completions、Responses
Anthropic Messages	`https://bettertoken.ai`	直接调用 API 时使用 `x-api-key: YOUR_API_KEY`	Messages；客户端会添加 `/v1/messages`

一个 BetterToken API Key 可调用所有可用模型。按客户端选择协议：Claude Code 可通过 Anthropic Messages 调用 GPT 和其他可用模型。受客户端限制，Claude Desktop 仅支持 Claude 模型，请按其 Gateway 指南配置。

流式输出和工具调用的支持情况因模型而异。使用前，先用你的 Model ID 测试小请求，再参考流式输出与工具调用指南。图片任务请使用上方对应指南；BetterToken 不支持搜索辅助生图。

查看用量与控制成本

打开 BetterToken 控制台，查看每次请求的模型、状态、Token 用量和费用。你可以为不同项目创建多个 API Key，并在高级设置中设置有效期或消费上限，操作见快速接入。

余额耗尽时，请求会被拒绝。缓存规则请参阅缓存计费常见问题；遇到限额提示时，请参阅用量限额常见问题。

支付方式

你可以通过 Stripe 或 USDT 支付。账户当前可用的支付方式以 Workspace 显示为准。

常见问题

应该填写哪个 Base URL？

Anthropic SDK 和 Claude Code 使用 https://bettertoken.ai，OpenAI SDK 和 Codex CLI 使用 https://bettertoken.ai/v1。Base URL 常见问题说明了客户端字段和路径后缀。

如何确认配置成功？

发送一个简短请求，读取响应，再到控制台查找匹配的记录。如果失败，先按错误与限制排查，再决定是否重试。