新手接入指南

把 AI 模型接进你的软件,
从下面三样东西开始。

不需要会写代码。准备好地址、密钥、模型这三样,在任何支持自定义接口的软件里照着填,就能发出第一条消息。每一步都写清了「点哪里、填什么」。

01一个接口地址

告诉软件去哪里请求:https://www.652333.xyz/v1

02你自己的 API 密钥

在控制台创建,以 sk- 开头,填进软件。

03一个可用模型

六大系列任选,名字见 模型与分组。

填好 → 保存 → 发一条「只回复 OK」测试
选入口

你想怎么接?

✓接入只要三件事:先在控制台创建密钥;地址照本页抄;第一次先发「只回复 OK」测试,确认通了再正式用。
01

接入准备

三样东西,五分钟准备完。准备好之后可以直接跳到 02 软件对接。

① 接口地址

你的软件按哪种协议接,就抄哪一行:

软件类型要填的地址说明
OpenAI 兼容软件(绝大多数聊天客户端)https://www.652333.xyz/v1软件一般会自动在后面拼 /chat/completions,你只填到 /v1
Anthropic 协议(Claude Code 等)https://www.652333.xyz只填域名,工具会自己拼 /v1/messages

⚠ 常见错误:末尾多加 /chat/completions 或少写 /v1,都会连不上。

② 创建 API 密钥

  1. 登录控制台右上角「进入控制台」
    没有账号先注册一个。
  2. 打开「API 密钥」页面左侧菜单
    点「新建密钥」。
  3. 选分组
    分组决定你用哪条线路、按什么价格计费:稳定版走更稳的线路、价格略高;特惠版价格更低。同一批模型两个版本都有。
  4. 复制密钥sk- 开头
    只显示一次,当场复制保存好。
!密钥就是钱包钥匙:不要发给别人、不要写进公开的代码仓库。泄露了就在控制台把它删掉重建。

③ 选一个模型

六大系列、共 20 个模型可选,完整名单和每档价格见 04 模型与分组 和 模型价格页。第一次接入建议挑一个便宜的练手,比如 gpt-6-luna 或 glm-5.3-flash。

02

文本对话对接

让聊天客户端、写作工具能对话。所有支持「自定义 OpenAI 接口」的软件都按这三步填。

通用三步(适用于任何 OpenAI 兼容软件)

  1. 找到「模型服务 / 供应商 / API 设置」
    一般在设置里,叫「添加供应商」「自定义模型」或「API 配置」。
  2. 填三样
    接口地址 https://www.652333.xyz/v1;密钥粘贴你的 sk-;模型手动输入名字(见 模型表)。
  3. 保存并发一条测试
    发「只回复 OK」。回复了就接通了。

Cherry Studio

  1. 设置 → 模型服务 → 添加底部「添加」按钮
  2. 填写供应商
    名称随意(如「沐晨云栈」);API 地址填 https://www.652333.xyz/v1;密钥粘贴 sk-。
  3. 添加模型
    点「管理」或「+」,手动输入模型名,例如 gpt-6-luna、deepseek-v4.1-flash。
  4. 回到对话页,选中刚加的模型
    发「只回复 OK」验证。

Chatbox

  1. 设置 → 模型 → 添加自定义提供方
  2. 选「OpenAI 兼容」类型
    API Host 填 https://www.652333.xyz(有的版本要求带 /v1,以界面提示为准);API Key 粘贴 sk-。
  3. 模型一栏填模型名
    如 glm-5.3-flash,保存。
  4. 发「只回复 OK」验证

不同版本界面略有差异,认准关键词「自定义 / OpenAI 兼容 / API Host」。

一分钟命令行验证

不用装任何软件,确认密钥和地址是否可用:

curl · 替换 sk-xxx 后直接运行
curl https://www.652333.xyz/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer sk-你的密钥"   -d '{
    "model": "gpt-6-luna",
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

返回里有 "content": "OK" 就是通了。

Python 调用示例

python · 官方 openai 库
# pip install openai
from openai import OpenAI

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

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "只回复 OK"}],
)
print(resp.choices[0].message.content)
03

编程助手对接

Claude Code、Codex 这类命令行工具不进图形界面设置,用环境变量接入。

Claude Code

走 Anthropic 协议,设两个环境变量后正常启动即可:

Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://www.652333.xyz"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude
macOS / Linux
export ANTHROPIC_BASE_URL="https://www.652333.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

模型用 claude-opus-5-5、claude-opus-5、claude-haiku-5-5,可在 Claude Code 内用 /model 切换。

✓想固定用某个模型,可再加 ANTHROPIC_MODEL 环境变量,值填模型名。

Codex 及其它 OpenAI 兼容 CLI

凡支持自定义 base_url 的工具,都指向:

通用环境变量
OPENAI_BASE_URL = https://www.652333.xyz/v1
OPENAI_API_KEY  = sk-你的密钥

工具界面里若有「模型提供商 / Provider」配置,同样填这两项。模型建议用 gpt-6.1-sol 或 kimi-k2.7-code。

自己写程序调用(Anthropic 协议)

python · anthropic 库
# pip install anthropic
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-你的密钥",
    base_url="https://www.652333.xyz",
)

msg = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=64,
    messages=[{"role": "user", "content": "只回复 OK"}],
)
print(msg.content[0].text)
04

模型与分组

每个系列都有「稳定版」和「特惠版」两条线路,模型名相同、价格不同。你建密钥时选的分组,决定可用模型和计费档位。

系列可用模型(调 API 时用的名字)适合
GPTgpt-6.1-sol · gpt-6-luna · gpt-5.6-luna · gpt-6-astra通用对话、写作
DeepSeekdeepseek-v4.1-flash · deepseek-v4-flash · deepseek-v4-flash-0731 · deepseek-v4.1-flash-1017 · deepseek-v4-pro高性价比长文、推理
GLMglm-5.3 · glm-5.3-flash日常对话、快速响应
Kimikimi-k3 · kimi-k2.8 · kimi-k2.7-code长上下文、代码
Qwenqwen3.8-max · qwen3.8-flash · qwen3.7-plus中文任务、通用
Claudeclaude-opus-5-5 · claude-opus-5 · claude-haiku-5-5编程助手、复杂任务
!模型名必须一字不差(全小写、含点号)。拼错会报「模型不存在」。每档实时价格看 模型价格页,页面数据与计费一致。

计费方式

按 输入 / 输出 token 计费,不同模型价格不同;带「flash」「luna」「haiku」字样的型号通常是同系列里的低档位,更便宜。每次调用的逐笔账单可在控制台「使用日志」里查到,花在哪里一目了然。

05

常见问题

提示 401 / 密钥无效?
检查三点:① 密钥是否完整复制(sk- 开头,前后不能有空格);② 密钥是否被删除或禁用(控制台 → API 密钥里看状态);③ 密钥是否填错了位置(Authorization 头里要不要 Bearer 前缀,按软件要求)。
提示模型不存在(model not found / 404)?
① 模型名拼错了,对照 模型表 一字不差地填;② 你的密钥所在分组不包含这个模型——换一个包含它的分组重新建密钥,或换模型。
提示 503 / 服务暂时不可用?
当前线路繁忙,稍等几秒重试即可;持续出现可换同系列的另一个模型,或在控制台把密钥换到另一条线路(稳定版 / 特惠版)。
软件里连不上 / 超时?
九成是地址填错。对照检查:OpenAI 兼容软件填 https://www.652333.xyz/v1(不要多拼 /chat/completions);Anthropic 协议工具只填 https://www.652333.xyz(不要加 /v1)。先用 curl 命令验证密钥本身是好的,再查软件配置。
怎么知道自己花了多少钱?
控制台 → 使用日志,每一次调用都有单独一条记录:用了哪个模型、多少 token、扣了多少。余额在控制台首页。
支持流式输出吗?
支持。请求里加 "stream": true 即可,聊天客户端默认就是流式,无需额外设置。
一个密钥能多处使用吗?
能。同一个密钥可以同时用在手机、电脑、多个软件里,用量合并计费。介意的话可以为每台设备单独建密钥,方便分开查账。