配置教程 / 快速开始

快速开始：3 分钟上手指引

跟随本篇保姆级教程，轻松获取密钥、配置任意聊天软件或开发环境，快速发出第一条 AI 对话。

1. 注册账号与充值

打开注册页面创建账号并完成登录；
前往资金账户，选择适合您的金额进行充值（支持支付宝、微信扫码、银行卡及 Apple Pay / Google Pay，支付确认后额度自动到账）。

2. 创建 API令牌并选择分组

前往控制台 → API令牌，点击「创建API令牌」按钮：

智能API组（推荐新手）：无需挑选模型，客户端直接填模型 Bestoo-Auto，由系统按任务自动匹配能力、必要时升级，统一单价；
普通组（双通道高可用 · 低至官方价 1 折起）：价格低，线路故障时自动切换备用上游（模型名如 gpt-5.6-sol、claude-sonnet-5-5 等）；
官方组（官方模型 · 官方价 ×1.1）：厂商官方型号，不做模型替换，模型名带厂商前缀（如 openai/gpt-5.6-sol、anthropic/claude-sonnet-5.5 等）。

现在去创建密钥

3. 复制接入地址 (Base URL)

绝大多数客户端（Cherry Studio、NextChat、Cursor、Open WebUI 等）：请完整填写带 /v1 的地址；
个别客户端（如 ChatBox，其后台会自动拼接 /v1）：请填写 https://www.flowstoken.com；
注意：请勿在地址末尾添加多余空格或拼接 /chat/completions。

4. 核心技巧：模型同步与客户端区别

通用对话客户端（首推 Cherry Studio、ChatBox 等）：
在客户端填好 API 地址与 API令牌后，直接点击界面中的 「管理 / 拉取模型」/「获取模型列表」/「🔄 刷新」 按钮。
FlowsToken 会自动把当前密钥能用的全部模型一次性拉取出来，勾选即可开始对话，完全无需手动手敲模型名字。

编程智能体客户端（首推 OpenCode / Cline，以及 Aider、Goose 等）：
Cline 会自动拉取模型列表、下拉即选；其余工具不自动拉取，需要点击 「+ 添加模型 / Add Model」 手动添加：
1. Base URL 写法：OpenCode / Aider / Cline 填 https://www.flowstoken.com/v1（带 /v1）；Goose 的 OPENAI_HOST 填 https://www.flowstoken.com（不带 /v1，它会自动拼接）；
2. 模型名称必须匹配 Key 分组：智能API组填 Bestoo-Auto；官方组填带厂商前缀的模型名（如 zai/glm-5.3、anthropic/claude-sonnet-5.5）；普通组填不带前缀的模型名（如 gpt-5.6-sol）。
👉 模型复制秘诀：不知道想用的模型全称？前往模型广场，在顶部选择您的 Key 对应分组，直接复制想用的模型名称粘贴进去。详见 OpenCode / Aider / Goose 接入指引

想生成图片？图片模型（如 gpt-image-2、google/gemini-2.5-flash-image）的调用方式与聊天模型不同，请看图片生成教程。

5. 常见报错排查

401 Invalid Token / Unauthorized

可能原因：
1. 复制密钥时多选了空格或漏选了字符；
2. 该密钥在控制台已被删除或处于禁用状态；
3. 客户端残留了旧平台的失效密钥。
解决方法：在控制台创建新令牌，点击完整复制并重新粘贴。

无可用渠道 / Model Not Found

可能原因：
模型名与密钥分组不匹配。例如：创建了「智能API」组密钥，却手动调用普通组模型；或创建了普通组密钥，却调用了官方组带厂商前缀的模型。
解决方法：点击客户端的「拉取模型」按钮，系统会自动加载对应分组的模型列表，直接选择即可。

402 余额不足 (Insufficient Quota)

可能原因：账户额度已耗尽。
解决方法：前往资金账户补充额度，支付确认后额度自动到账。

6. 开发者代码调用示例（选读）

如果您是通过代码调用 API 的开发者，请参考以下标准调用示例：

curl 示例（支持一键复制单行命令）

curl

curl https://www.flowstoken.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Bestoo-Auto",
    "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]
  }'

Python 示例 (使用官方 OpenAI 库)

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://www.flowstoken.com/v1"
)

response = client.chat.completions.create(
    model="Bestoo-Auto",  # 或普通组 gpt-5.6-sol / 官方组 openai/gpt-5.6-sol
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

查看各客户端配置图文返回教程首页