配置教程 / 快速开始

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

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

1. 注册账号与充值

打开注册页面创建账号并完成登录；
前往充值中心，选择适合您的金额进行充值（支持微信扫码、银行卡及 Apple Pay / Google Pay，额度美元 1:1 即刻到账）。

2. 创建 API 密钥并选择分组

前往控制台 → API 密钥，点击「添加令牌」按钮：

智能API组（推荐小白使用）：无需挑选模型，客户端直接填模型 bestoo-auto，由系统自动分流到最合适的高性能大模型；
普通组（双通道高可用 · 官方1~3折）：性价比首选，支持智能故障容灾（模型名如 gpt-5.6-sol、claude-sonnet-4-6 等）；
官方组（官方模型 · 官方价直售）：官方模型不做替换（模型名带厂商前缀，如 openai/gpt-5.6-sol、anthropic/claude-sonnet-4.6 等）。

现在去创建密钥

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、anthropic/claude-sonnet-4.6）；普通组填不带前缀的模型名（如 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)

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