欢迎使用【好西西 API😀】。本平台提供统一的大模型 API 接入服务，兼容 OpenAI 接口格式，适合在支持 OpenAI API 的软件、插件、脚本或业务系统中使用。
使用文档
一、服务说明
好西西 API 是一个大模型 API 中转服务平台。
你可以通过本平台提供的 API Key，在各类支持 OpenAI 接口格式的工具中调用可用模型。
请注意：
-
API Key 代表你的账户权限和余额。
-
不要把 API Key 公开发布到群聊、网页、GitHub、论坛等公共位置。
-
因 API Key 泄露造成的消耗，通常由账号本人承担。
-
请合法合规使用本服务。
二、接口地址
1. Base URL
2. 聊天接口
3. 模型列表接口
三、获取 API Key
方式一：已有账号
-
打开好西西 API 网站：https://api.haoxixi.com.cn
-
登录你的账号。
-
进入「令牌管理」。
-
点击创建令牌。
-
复制生成的 API Key。
-
妥善保存 API Key。
方式二：没有账号
如果你还没有账号，请联系管理员开通。
联系客服时可以说明：
我要开通好西西 API 账号
四、在软件中怎么填写
大部分支持 OpenAI 接口的软件，通常需要填写两个内容：
-
Base URL
-
API Key
你可以这样填写：
Base URL
API Key
填写你在「令牌管理」中创建的密钥。
如果软件要求填写接口路径，一般填写：
/v1/chat/completions
如果软件要求填写完整接口地址，可以填写：
五、调用示例
下面是一个基础调用示例。
请把「你的API密钥」替换成你自己的 API Key。
请把「模型名称」替换成平台实际可用的模型名称。
curl 请求示例：
curl https://api.haoxixi.com.cn/v1/chat/completions -H “Content-Type: application/json” -H “Authorization: Bearer 你的API密钥” -d ’{ “model”: “模型名称”, “messages”: [ { “role”: “user”, “content”: “你好，请介绍一下你自己” } ] }‘
六、支持哪些模型
平台支持的模型以「模型广场」和管理员公告为准。
不同模型的能力、速度、价格可能不同。
使用前请确认：
-
模型是否已开放
-
账户余额是否充足
-
当前账号或分组是否有权限使用该模型
-
软件里填写的模型名称是否正确
如果你不确定该使用哪个模型，请联系管理员。
七、充值与计费
平台按实际调用消耗扣费。
不同模型的价格可能不同，具体价格以平台公告或管理员说明为准。
如需充值，请联系管理员。
充值前建议确认：
-
账号名称
-
充值金额
-
是否需要指定模型
-
是否需要开具相关凭证
八、常见问题
1. 提示 API Key 无效怎么办？
请检查：
-
API Key 是否复制完整
-
API Key 前后是否有多余空格
-
令牌是否被删除
-
令牌是否被禁用
-
账号是否正常
如果仍然无法使用，请联系管理员。
2. 提示余额不足怎么办？
说明账户余额不足，请联系管理员充值。
3. 提示模型不存在或不可用怎么办？
请检查：
-
模型名称是否填写正确
-
模型是否已在平台开放
-
当前账号是否有权限使用该模型
-
软件是否自动改写了模型名称
如果不确定模型名称，请以平台「模型广场」或管理员说明为准。
4. 请求失败或没有返回怎么办？
请检查：
-
Base URL 是否填写正确
-
API Key 是否填写正确
-
账户余额是否充足
-
模型名称是否正确
-
网络连接是否正常
-
请求内容是否过长
-
当前模型是否可用
如果问题持续存在，请联系管理员，并提供报错截图。
5. 可以把 API Key 发给别人用吗？
不建议。
API Key 代表你的账户权限和余额。别人使用你的 API Key 产生的消耗，会计入你的账户。
如需多人使用，建议分别创建账号或分别创建令牌。
6. 忘记 API Key 怎么办？
出于安全考虑，API Key 通常不会完整展示第二次。
如果忘记了，可以进入「令牌管理」重新创建一个新的令牌，并删除旧令牌。
九、使用规范
请合法合规使用本服务。
不得将本服务用于以下场景：
-
违法违规内容
-
欺诈、诈骗、钓鱼
-
恶意注册、恶意刷量
-
攻击、扫描、入侵他人系统
-
侵犯他人隐私或权益
-
批量滥用平台资源
-
其他违反法律法规或平台规则的用途
如发现异常使用，平台有权限制、暂停或关闭相关账号。
十、安全建议
为了保护你的账户和余额，请注意：
-
不要把 API Key 发到公开群聊
-
不要把 API Key 写进公开代码仓库
-
不要把 API Key 截图发给陌生人
-
不要使用来历不明的软件保存 API Key
-
如怀疑 API Key 泄露，请立即删除旧令牌并创建新令牌
十一、联系客服
如需开通账号、充值、咨询模型、处理报错，请联系管理员。
客服微信：haorannba
联系管理员时，建议提供：
-
账号名称
-
问题截图
-
使用的软件名称
-
报错信息
-
大概发生时间
这样可以更快定位问题。
十二、快速复制信息
Base URL
Chat Completions 接口
Models 接口
Authorization 格式
Authorization: Bearer 你的API密钥
Claude Code 与 Codex 安装教程
本文档面向已购买好西西 API 的用户，指导你在电脑上安装并配置 Claude Code 和 Codex。
使用前请先准备好：
-
好西西 API 地址：
https://api.haoxixi.com.cn -
你的 API Key：在好西西 API 平台「令牌管理」中创建
-
一台 Windows / macOS / Linux 电脑
请注意：API Key 代表你的账户余额和使用权限，不要发到群聊、网页、GitHub 或其他公开位置。
一、先获取你的 API Key
-
打开好西西 API 平台：
https://api.haoxixi.com.cn -
登录你的账号。
-
进入「令牌管理」。
-
点击创建令牌。
-
复制生成的 API Key。
API Key 一般类似：
sk-xxxxxxxxxxxxxxxx
如果你还没有账号，请联系管理员开通。
二、安装前准备：安装 Node.js
Claude Code 和 Codex 都需要 Node.js 环境。
Windows 用户
-
打开 Node.js 官网：
https://nodejs.org -
下载 LTS 长期支持版。
-
一路点击下一步安装。
-
安装完成后，打开 PowerShell。
-
输入：
node -v -
如果能看到版本号，例如：
v22.x.x说明 Node.js 安装成功。
macOS 用户
推荐使用 Node.js 官网安装包：
https://nodejs.org
安装完成后，打开终端，输入：
node -v
能看到版本号即可。
Linux 用户
如果你熟悉命令行，可以使用系统包管理器或 NodeSource 安装 Node.js。
安装后检查：
node -v
三、安装 Claude Code
Claude Code 是 Anthropic 的命令行编程助手。配置好后，可以通过好西西 API 使用兼容接口。
1. 安装 Claude Code
打开终端或 PowerShell，执行：
npm install -g @anthropic-ai/claude-code
安装完成后，检查是否成功：
claude --version
如果能看到版本号，说明安装成功。
四、配置 Claude Code 使用好西西 API
Windows 配置方式
打开 PowerShell，执行下面两行。
第一行，设置 API 地址：
setx ANTHROPIC_BASE_URL "https://api.haoxixi.com.cn"
第二行，设置 API Key：
setx ANTHROPIC_AUTH_TOKEN "你的API密钥"
请把 你的API密钥 替换成你自己的 Key。
设置完成后，关闭当前 PowerShell，重新打开一个新的 PowerShell。
然后输入：
claude
如果能进入 Claude Code 交互界面，说明配置成功。
macOS / Linux 配置方式
打开终端，执行：
export ANTHROPIC_BASE_URL="https://api.haoxixi.com.cn"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
然后输入：
claude
如果能进入 Claude Code 交互界面，说明配置成功。
如果你想永久保存配置，可以把上面两行加入 ~/.zshrc 或 ~/.bashrc。
五、安装 Codex
Codex 是 OpenAI 的命令行编程助手。配置好后，可以通过好西西 API 使用兼容 OpenAI 格式的接口。
1. 安装 Codex
打开终端或 PowerShell，执行：
npm install -g @openai/codex
安装完成后，检查是否成功：
codex --version
如果能看到版本号，说明安装成功。
六、配置 Codex 使用好西西 API
Codex 通常使用 OpenAI 兼容接口，因此需要配置：
-
API 地址
-
API Key
Windows 配置方式
打开 PowerShell，执行：
setx OPENAI_BASE_URL "https://api.haoxixi.com.cn/v1"
setx OPENAI_API_KEY "你的API密钥"
请把 你的API密钥 替换成你自己的 Key。
设置完成后，关闭当前 PowerShell，重新打开一个新的 PowerShell。
然后输入：
codex
如果能正常进入 Codex，说明安装成功。
macOS / Linux 配置方式
打开终端，执行：
export OPENAI_BASE_URL="https://api.haoxixi.com.cn/v1"
export OPENAI_API_KEY="你的API密钥"
然后输入：
codex
如果能正常进入 Codex，说明安装成功。
如果你想永久保存配置，可以把上面两行加入 ~/.zshrc 或 ~/.bashrc。
七、Base URL 应该怎么填
不同软件填写方式可能不一样。
如果软件要求填写 Base URL：
https://api.haoxixi.com.cn
如果软件明确要求 OpenAI Base URL：
https://api.haoxixi.com.cn/v1
如果软件要求填写 Chat Completions 完整地址：
https://api.haoxixi.com.cn/v1/chat/completions
注意：/v1/chat/completions 是程序调用接口，不是普通网页，不要直接用浏览器打开。
八、常见问题
1. 提示 API Key 无效怎么办？
请检查：
-
API Key 是否复制完整
-
API Key 前后是否有多余空格
-
令牌是否被删除或禁用
-
账户是否正常
2. 提示余额不足怎么办？
说明账户余额不足，请联系管理员充值。
3. 提示模型不可用怎么办？
请确认：
-
当前平台是否开放该模型
-
你的账号是否有权限使用该模型
-
软件中填写的模型名称是否正确
4. 命令提示 npm 不是内部或外部命令怎么办？
说明 Node.js 没有安装成功，或者安装后没有重新打开终端。
处理方式：
-
重新安装 Node.js LTS 版本。
-
安装完成后关闭终端。
-
重新打开终端。
-
输入
node -v和npm -v检查。
5. 配置后还是不生效怎么办？
Windows 用户请确认：
-
使用
setx后需要关闭当前 PowerShell -
必须重新打开新的 PowerShell
-
API Key 没有多复制空格
macOS / Linux 用户请确认：
-
当前终端里已经执行过
export -
如果写入了
~/.zshrc，需要重新打开终端或执行source ~/.zshrc
九、安全提醒
请不要把 API Key：
-
发到微信群、QQ群
-
写到公开 GitHub 仓库
-
截图发给陌生人
-
放到公开网页
-
交给不可信的软件或插件
如果怀疑 API Key 泄露，请立即进入「令牌管理」删除旧令牌，并创建新令牌。
十、联系客服
如果你在安装或配置过程中遇到问题，请联系管理员，并提供：
-
你的账号名称
-
使用的系统：Windows / macOS / Linux
-
安装的软件：Claude Code / Codex
-
报错截图
-
大概操作到哪一步
客服微信：haorannba