接入你的应用
大多数支持自定义 OpenAI 兼容服务的客户端，都需要填写地址、密钥和模型三项。
准备好这三项
| 项目 | 内容 |
|---|---|
| 完整 API Base URL | https://guangjiapi.top/v1 |
| API Key | 在光迹 API 控制台创建的模型调用密钥 |
| 模型 ID | 从光迹 API 模型广场复制，需与密钥分组相匹配 |
只改地址不改密钥，或使用其他平台的密钥，都无法完成光迹 API 的鉴权。
地址应该怎么填
不同工具对地址字段的处理方式不同。以客户端最终请求路径为判断依据：
| 客户端要求 | 填写内容 |
|---|---|
| 完整 OpenAI Base URL | https://guangjiapi.top/v1 |
仅服务根地址，工具会自动补 /v1 | https://guangjiapi.top |
| 完整聊天补全请求地址 | https://guangjiapi.top/v1/chat/completions |
聊天补全请求最终应落在 /v1/chat/completions。如果出现 /v1/v1/chat/completions，说明重复添加了 /v1。
不要把控制台地址 /dashboard、登录地址 /sign-in 或完整接口路径填进只接受基础地址的字段。
通用配置顺序
- 在客户端设置里添加服务商，选择 OpenAI 兼容或等价类型。
- 将名称设为「光迹 API」，填写正确的地址。
- 粘贴完整 API Key。
- 获取模型列表，或手动添加平台模型广场中的模型 ID。
- 保存配置，在聊天页面选择刚添加的模型，发送短消息测试。
选择你的接入方式
- 桌面聊天客户端：Cherry Studio。
- 桌面 AI 助手：WorkBuddy 图文接入教程。
- AI 编程工具配置：CC Switch 一键接入图文教程，支持从光迹控制台导入。
- 程序或服务端应用：API 调用示例。
- 想让回答逐段出现：流式输出。
不是所有模型都支持相同协议或能力。图片、语音、工具调用和长上下文等功能，需要同时获得模型、平台和客户端支持。