Getting started

从 API Key 到第一次请求

这份教程把注册、充值、用量、OpenAI SDK、Responses、CCSwitch 和故障排查放在一条路径里。每一步都以控制台实时显示为准,适合新用户和迁移现有客户端。

1. 创建密钥和分组

登录控制台,打开“API 密钥”,创建一枚独立密钥并选择服务分组。密钥完整值只在创建时展示;按项目分开创建,方便撤销和核对用量。

2. 配置统一入口

OpenAI 兼容客户端的 Base URL 使用 https://shushutoken.com/v1。请求头使用 Authorization: Bearer 你的 API Key,模型名填写控制台允许列表中的实际 ID。

3. 完成小额测试

先发送短文本、非流式请求,确认返回结构、模型 ID、状态码和使用记录,再开启流式、工具调用或图片输入。

4. 查看用量和账单

在“使用记录”按时间、模型和密钥核对输入输出 token、状态和费用;充值、订阅与订单在对应页面查看。

OpenAI compatible

Python 请求示例

模型名必须替换为你所属分组当前允许的 ID。

from openai import OpenAI

client = OpenAI(
    api_key="你的 API 密钥",
    base_url="https://shushutoken.com/v1",
)
response = client.chat.completions.create(
    model="控制台中的模型 ID",
    messages=[{"role": "user", "content": "请回复:连接成功"}],
)
print(response.choices[0].message.content)

Responses 请求

需要 Responses 格式时,使用客户端提供的 responses.create,仍先确认模型、分组和字段兼容性。本站的 /responses 路径由业务接口处理,未认证请求会返回 401。

response = client.responses.create(
    model="控制台中的模型 ID",
    input="请回复:连接成功",
)
print(response.output_text)

充值、订阅和订单

  1. 在控制台打开充值或订阅入口,选择当前可用方案。
  2. 支付完成后返回订单页确认状态,不要只凭支付页面判断余额。
  3. 回到余额和使用记录核对到账与扣费。

任何异常都保留订单号、时间和页面状态;公开反馈中不要发送密钥或支付敏感信息。

CCSwitch / GPT 配置

把统一入口接入桌面客户端

不同版本的 CCSwitch 菜单名称可能不同,核心字段保持一致:供应商名称、Base URL、API Key、模型映射和路由顺序。

填写连接信息

  • Provider:自定义 OpenAI 兼容服务。
  • Base URL:https://shushutoken.com/v1。
  • API Key:控制台创建的密钥。
  • Model:控制台允许列表中的模型 ID。

保存后验证

  • 先发一条短消息,确认响应和模型回显。
  • 切换模型时只改模型字段,保留同一密钥和入口。
  • 遇到 401、402 或 429,按下面状态码表排查。
Troubleshooting

错误码快速排查

状态常见原因排查步骤
401密钥无效、停用或请求头错误检查 Bearer 格式、密钥完整性、分组权限;不要把 Key 写进 URL。
402余额或订阅额度不足查看余额、充值订单和订阅状态,到账后重试一次。
429请求过快、并发或分组限流降低并发,使用指数退避;持续出现时切换有权限的分组。
5xx上游或网关临时异常记录 request id 和时间,稍后重试;持续异常再提交支持请求。

安全边界

API Key 等同密码,不提交到 Git、截图、浏览器公开扩展或社区帖子。客户端支持环境变量时优先使用环境变量;怀疑泄露时立即撤销并创建新密钥。

查看安全说明 → · 查看隐私说明 →