52 5233AI API 开发者文档
/
5233AI API 使用指南

从兑换码到第一次
API 调用

面向第一次使用 API 的用户。按照本页顺序完成注册、充值、创建密钥和客户端配置。

控制台
newapi.5233ai.com
API Base URL
https://newapi.5233ai.com/v1
鉴权方式
Bearer API Key
01

快速开始

四步完成配置

1

注册并登录

进入控制台,使用邮箱完成注册和登录。

查看步骤
2

兑换额度

在“兑换”页面输入购买的兑换码,额度实时到账。

查看步骤
3

创建密钥

创建一枚 API Key,并立即保存到本地安全位置。

查看步骤
4

连接客户端

使用 CC Switch 配置 Codex,或直接调用兼容接口。

查看步骤
02

账户

注册与登录

  1. 1

    打开控制台

    访问 newapi.5233ai.com,点击右上角“登录”。

  2. 2

    创建账户

    选择注册,填写用户名、邮箱和密码。邮箱验证码仅从本站官方邮件地址发送。

  3. 3

    进入控制台

    登录后可看到钱包余额、令牌管理、使用日志和兑换入口。

收不到验证码

先检查垃圾邮件,等待 60 秒后重试。仍未收到时联系客服并提供注册邮箱和操作时间,不要提供密码。

03

钱包

使用兑换码充值

01购买兑换码从官方或授权代理购买
02进入“兑换”控制台左侧菜单
03输入并确认额度实时计入钱包
  1. 1

    打开兑换页面

    登录控制台,在左侧菜单点击“兑换”。

  2. 2

    粘贴兑换码

    完整输入兑换码,注意不要带入前后空格。

  3. 3

    核对余额

    兑换成功后进入“钱包管理”核对额度和兑换记录。

兑换码只能使用一次

不要在群聊、截图或远程协助窗口中公开兑换码。若提示已使用,请保留购买记录并联系客服。

04

鉴权

创建 API 密钥

  1. 1

    进入令牌管理

    控制台左侧选择“令牌管理”,点击“添加令牌”。

  2. 2

    设置名称和额度

    建议按用途命名,例如“CC Switch - 办公电脑”。新用户可以先使用默认限制。

  3. 3

    保存密钥

    创建后复制以 sk- 开头的密钥。密钥相当于密码,仅保存在自己的设备中。

API Key 示例
sk-••••••••••••••••••••••••••••a7F2 请勿公开完整密钥
05

客户端

使用 CC Switch

CC Switch 是开源的 AI 编程 CLI 管理工具,可统一管理 Codex、Claude Code、Gemini CLI 等客户端的供应商配置。

  1. 1

    安装并打开 CC Switch

    Windows 选择最新的 Windows.msi 安装包。macOS 和 Linux 按官方页面选择对应版本。

  2. 2

    选择 Codex 并添加供应商

    点击“添加供应商”,选择 Codex;没有本站预设时选择“自定义配置”。

  3. 3

    填写本站参数

    名称填写“5233AI”,API 地址填写下方 Base URL,密钥填写刚创建的 sk-...

  4. 4

    启用并重启客户端

    保存后点击“启用”。关闭并重新打开终端或 Codex 客户端,让新配置生效。

供应商名称5233AI
API Base URLhttps://newapi.5233ai.com/v1
API Keysk-你的密钥
模型从 /v1/models 查询可用模型
切换后没有生效

大多数 CLI 工具需要重新打开终端或客户端。CC Switch 官方说明中,Claude Code 是例外,可直接热切换。

06

Codex

连接并测试 Codex

  1. 1

    在 CC Switch 启用 5233AI

    确认当前 Codex 供应商显示为 5233AI。

  2. 2

    重新打开 Codex

    关闭旧终端或客户端窗口,再重新启动。

  3. 3

    发送最小测试请求

    新建对话并发送“只回复 OK”。成功后再开始长任务。

不要复用已经反复报错的旧对话

旧对话可能包含过大的上下文。出现连续流中断时,新建对话测试能更快区分客户端问题和线路问题。

07

API

接口基础

GET/v1/models查询当前密钥可用模型
POST/v1/chat/completionsOpenAI Chat Completions 兼容接口
POST/v1/responses适用于支持 Responses API 的客户端

请求头

HTTP
Authorization: Bearer sk-你的密钥
Content-Type: application/json
08

API

Chat Completions

cURL
curl https://newapi.5233ai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

示例模型仅用于演示。如果返回“模型不存在”或“未配置价格”,请先查询当前密钥可用的模型名称。

09

API

Responses API

cURL
curl https://newapi.5233ai.com/v1/responses \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "input": "只回复 OK"
  }'
10

模型

查询可用模型

cURL
curl https://newapi.5233ai.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

接口返回的 data[].id 就是请求时需要填写的模型名称。不同套餐和分组看到的模型可能不同。

11

排查

常见错误

401 Invalid API key

检查密钥是否完整、是否带有多余空格,以及请求头是否为 Authorization: Bearer sk-...。密钥被禁用后需要重新创建。

模型尚未配置价格

该模型暂未对当前分组开放。先调用 /v1/models 查询可用模型,不要自行修改模型名称猜测。

stream disconnected before completion

先新建短对话重试,并确认客户端 Base URL 正确。若多个短请求仍中断,记录发生时间、模型和请求 ID 后联系客服。

429 请求过多

降低并发和重试频率。连续快速重试会延长限制时间,建议等待 30 至 60 秒再测试。

HTTP 530 或上游响应异常

通常是上游线路或账号暂时不可用。不要重复提交同一长任务,稍后重试或联系管理员切换线路。

兑换码已使用或不存在

核对兑换码字符和购买渠道。向客服提供订单记录和兑换时间,不要在公开群聊中发送完整兑换码。

12

安全

保护 API 密钥

不要公开

不要把完整密钥放进截图、群聊、公开仓库或前端网页。

及时轮换

怀疑泄露时立即禁用旧密钥并创建新密钥。

设置限制

按设备创建独立密钥,并设置合理的额度和并发限制。

13

支持

联系客服与售后群

咨询时请准备:账号邮箱、发生时间、使用模型、错误提示和请求 ID。请勿发送密码或完整 API Key。

客服 QQ

1499887587

添加好友时备注“API 咨询”

售后交流群

群号 2150092719

进群后请勿公开密钥和兑换码
二维码大图
已复制