第一次使用

按你的目标阅读

邮箱注册

1. 打开 注册页面。
2. 填写常用邮箱，并设置至少 6 个字符的密码。
3. 点击“继续”，系统会向该邮箱发送 6 位验证码。
4. 输入验证码并点击“验证并创建”。未收到邮件时，等待倒计时结束后可重新发送。
5. 验证成功后会自动创建账户并进入仪表盘。

使用 Google 注册或登录

1. 在注册页或登录页点击“使用 Google 登录”。
2. 在 Google 授权页选择账号，并确认授权登录 ChatAPI。
3. 已完成注册和绑定的账号会直接登录并返回仪表盘。
4. 首次使用该 Google 账号时，按回调页面提示补设密码和确认密码；如果站点要求邀请码，还需填写有效邀请码。
5. 点击“完成注册”，成功后会自动登录。

邮箱密码登录

1. 打开主站，点击“登录”。
2. 填写注册邮箱和密码后提交。
3. 进入仪表盘后，先核对右上角账户名与余额。

仪表盘怎么看

创建密钥

1. 进入“API 密钥”，点击“创建密钥”。
2. 填写便于识别的名称，例如 codex-macbook 或 backend-production。
3. 选择平台，然后选择有可用渠道的分组。
4. 按需设置安全限制，点击“创建”。
5. 复制密钥并保存到密码管理器或服务端密钥系统。

创建选项

日常管理

密钥列表支持搜索、分组和状态筛选。你可以复制、启用、停用、修改分组、重置额度用量或删除密钥。删除操作不可撤销，轮换密钥时应先部署新密钥并验证，再停用旧密钥。

基础信息

Responses API

curl "https://chatapi.bwliangc.com/v1/responses" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": "用一句话解释什么是幂等性"
  }'

OpenAI Python SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CHATAPI_API_KEY"],
    base_url="https://chatapi.bwliangc.com/v1",
)

response = client.responses.create(
    model="gpt-5.6-terra",
    input="用一句话解释什么是幂等性",
)
print(response.output_text)

OpenAI JavaScript SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CHATAPI_API_KEY,
  baseURL: "https://chatapi.bwliangc.com/v1",
});

const response = await client.responses.create({
  model: "gpt-5.6-terra",
  input: "用一句话解释什么是幂等性",
});

console.log(response.output_text);

安装 CC-Switch

CC-Switch 是跨平台的 AI 编程工具供应商管理应用，支持 Codex、Claude Code 和 Gemini CLI 等客户端。

首次启动时允许应用注册 ccswitch:// 协议；ChatAPI 的一键导入依赖该协议唤起 CC-Switch。

从 ChatAPI 一键导入

1. 1

   准备密钥

   在 ChatAPI“API 密钥”页面创建一个 OpenAI 平台密钥，并确认它已分配可用分组。

2. 2

   打开导入窗口

   在该密钥的操作列点击“导入到 CCS”。如果没有此按钮，可能是站点暂时隐藏了 CCS 导入功能。

3. 3

   选择应用和模型

   平台选择“Codex”，主模型选择当前分组实际支持的模型。模型列表发生变化时，以“渠道状态”和导入窗口为准。

4. 4

   确认导入

   点击“导入”。系统询问是否打开 CC-Switch 时选择允许，再核对供应商名称、端点、模型和密钥后确认。

5. 5

   启用供应商

   在 CC-Switch 的 Codex 页面选中刚导入的 ChatAPI 供应商并点击“启用”，然后完全退出并重新启动 Codex。

导入内容

手动添加备用方案

深度链接无法使用时，可在 CC-Switch 点击“添加供应商”，为 Codex 创建自定义供应商：

保存后选中该供应商并点击“启用”。若主站连接失败，可将 API 地址换为 https://chatapis.cc。

发起测试

1. 先创建并启用一个 API 密钥。
2. 进入“在线测试”，选择密钥。
3. 刷新并选择模型，或输入模型名。
4. 输入消息，按需添加图片，然后发送。

适合排查什么

• 密钥是否启用并已分配分组。
• 模型是否在当前分组可用。
• 图片输入是否受模型支持。
• 问题来自平台配置还是本地 SDK/网络环境。

用量总览

“使用记录”顶部汇总所选时间范围内的请求数、输入/输出/缓存 Token、实际消费、标准消费和平均耗时。图表可按 Token 或实际消费查看模型、分组与端点分布。

筛选与明细

可按 API 密钥、模型、分组、类型、计费类型和计费模式筛选。明细表包含推理强度、端点、IP、Token、费用、延迟和时间；列设置可隐藏暂时不关心的字段。

导出与错误请求

• 点击“导出 CSV”保留筛选后的账单明细。
• 切换“错误请求”查看失败调用，结合状态码和时间定位问题。
• 比较“实际”与“标准”费用时，应同时考虑渠道倍率、缓存 Token 和计费模式。

购买 CDK

1. 登录后点击侧栏“CDK 购买”。
2. 在官方购买页面确认商品、金额和支付信息。
3. 支付完成后取得兑换码。
4. 回到 ChatAPI 控制台，不要把兑换码发给他人。

兑换

1. 进入“兑换”，确认当前余额与并发数。
2. 原样粘贴兑换码；兑换码区分大小写。
3. 点击“兑换”，等待余额、并发数或试用权限更新。
4. 在“最近活动”核对变更类型、时间和金额。

渠道状态

按渠道或模型搜索，查看渠道平台、可访问分组和支持模型。创建密钥前先在这里确认目标模型，能减少“模型不存在”或分组不匹配。

邀请返利

页面提供邀请码和邀请链接。被邀请用户充值后，邀请人按页面显示比例获得返利额度；可用返利可转入账户余额。比例和规则以页面实时显示为准。

消费排行榜

榜单按消费金额实时排名，并提供今日实时与昨日结算两个视图。奖池、参与门槛、奖励名额和分配比例会显示在榜单顶部，以当日规则为准。

推荐基线

• 为不同设备、应用和环境创建独立密钥。
• 生产密钥配置固定出口 IP 白名单。
• 测试和 CI 密钥设置额度、速率和有效期。
• 密钥写入环境变量或密钥管理服务，不进入前端代码。
• 发现泄露时立即停用旧密钥，创建并部署新密钥。

个人设置

“个人资料”支持修改用户名、头像和密码，管理邮箱及第三方登录绑定，配置余额不足邮件提醒。两步验证是否可用由站点管理员配置。

余额提醒

启用余额不足提醒并填写已验证邮箱。自定义阈值留空时使用系统默认值；生产业务建议设置能覆盖正常补充周期的阈值。

最小诊断请求

curl -i "https://chatapi.bwliangc.com/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

提交问题时保留请求时间、状态码、端点、模型和请求 ID。密钥只保留前后少量字符用于识别，其余部分必须打码。