SY Code 使用帮助
SY Code 快速配置
先进入用户中心创建令牌，再把 Base URL 和 API Key 填到你的客户端。遇到问题优先检查分组、协议、额度和代理。
主站按量
Base URL 填 https://www.syapi.vip/v1，按你的账户额度和渠道配置使用。
Codex / 客户端
接入模式选 API，协议优先使用 OpenAI 兼容或 Responses API。
SY Codex 一键工具
支持 Windows 和 Mac Apple Silicon，一键写入接口地址、令牌和模型配置。
生图单独确认
生图模型、分组和上游渠道需要在后台单独确认，避免和对话 Key 混用。
只看这一页也能配
1. 先区分入口
如果只想要一个统一入口，先打开 SY Code 主页 创建或复制令牌。
| 用途 | 地址 |
|---|---|
| 登录入口 | https://www.syapi.vip |
| API Base URL | https://www.syapi.vip/v1 |
| 计费方式 | 按后台额度、倍率和渠道规则扣费 |
同一个客户端里，Base URL 必须带 /v1。API Key 使用用户中心创建的令牌，不要填写上游平台的原始 Key。
2. 创建 Key
在用户中心进入令牌页面，新建令牌后复制完整 Key。建议按用途拆分，不同工具使用不同令牌，方便限额和停用。
| 场景 | 建议 |
|---|---|
| 日常对话 | 创建普通令牌，设置合理额度 |
| Codex / 开发工具 | 单独创建令牌，便于追踪请求 |
| 团队共享 | 每个人单独令牌，不共用管理员账号 |
3. 充值和兑换码
当前充值通过兑换码完成。进入主页后打开左侧“钱包”，在“添加资金”区域找到“需要兑换码？点击获取”，联系管理员获取兑换码后再填写兑换。
| 步骤 | 操作说明 |
|---|---|
| 进入钱包 | 登录 https://www.syapi.vip，在左侧菜单点击“钱包”。 |
| 获取兑换码 | 在“有兑换码吗？”下方点击“点击获取”，按提示联系管理员。 |
| 填写兑换码 | 把管理员提供的兑换码粘贴到输入框，点击“兑换额度”。 |
| 确认余额 | 兑换成功后查看“当前余额”，余额到账后即可继续调用 API。 |
充值前请确认登录的是自己的账号。兑换码通常只能使用一次，粘贴时不要带空格；如果兑换失败，把账号、兑换码和截图发给客服处理。
4. SY Codex 一键配置工具
SY Codex 用于快速配置 Codex 客户端，把接口地址、API Key 和模型参数一次性写好，适合不想手动改配置文件的用户。请按你的系统下载对应安装包。
SY-Codex 固定下载
安装后按提示填写后台令牌，接口地址保持 https://www.syapi.vip/v1。
| 配置项 | 填写说明 |
|---|---|
| Windows | SY-Codex_x64-setup.exe，固定版本入口。 |
| Mac Apple Silicon | SY-Codex_aarch64.dmg，固定版本入口，适用于 M 系列芯片 Mac。 |
| 接口地址 | https://www.syapi.vip/v1 |
| API Key | 填写 SY Code 后台“令牌”页面创建的 Key，不要填写上游平台原始 Key。 |
| 模型名称 | 选择或填写后台已启用的模型，模型不可用时先检查渠道和分组。 |
如果系统提示未知发布者，请确认下载地址是 www.syapi.vip 后再继续安装。Mac 用户如遇到安全拦截，可在系统设置的隐私与安全性里允许打开。安装完成后先用小额度令牌测试，确认能正常请求再用于正式工作。
5. Codex 这样填
| 字段 | 填写 |
|---|---|
| Base URL | https://www.syapi.vip/v1 |
| API Key | SY Code 用户中心创建的令牌 |
| 模型 | 填写后台已启用的模型名称 |
| 协议 | 优先选择 OpenAI 兼容；支持时可选择 Responses API |
如果客户端要求填写完整接口地址，通常是在 Base URL 后自动拼接接口路径，不要重复填写 /chat/completions。
6. 生图怎么用
生图是否可用取决于后台渠道和模型是否已开启。建议给生图创建独立令牌，方便控制费用和排查失败。
- 确认后台已经添加支持生图的上游渠道。
- 确认令牌允许使用对应模型和分组。
- 客户端里 Base URL 仍使用
https://www.syapi.vip/v1。 - 模型名称以后台渠道显示为准。
| image2 图生图 | 填写说明 |
|---|---|
| 接口 | 使用 edit 接口，支持图生图。 |
| Api | 填写 https://www.syapi.vip/v1。 |
| Key | 填写 SY Code 后台创建的令牌，不要填写上游平台原始 Key。 |
| 图片 | 上传参考图后输入修改指令，模型和尺寸以客户端支持项为准。 |
在 image2 中选择图生图或编辑模式时，接口类型选 edit；Api 填 https://www.syapi.vip/v1；Key 填后台令牌。
7. 出错先看
| 现象 | 处理 |
|---|---|
| 401 / 无效 Key | 重新复制用户中心令牌，确认没有多余空格 |
| 模型不可用 | 检查后台渠道、模型映射和令牌权限 |
| 余额不足 | 检查账户额度、倍率和充值记录 |
| 请求超时 | 关闭代理重试，或把 SY Code 域名加入直连 |
| 生图失败 | 确认生图模型、渠道和令牌权限单独配置正确 |