快速开始

第一次使用光迹 API，先完成下面四步。已经有密钥？可以直接前往 接入教程。

1. 登录光迹 API

打开 光迹 API 官网，点击「登录」。没有账号时，先按注册页面提示创建账户并完成邮箱验证。

登录后进入 控制台。在钱包或余额页面确认可用额度；需要充值时，按页面显示的方式操作。

2. 创建一把 API 密钥

打开控制台中的「API 密钥」（部分版本称「令牌」），点击创建。起一个容易辨认的名称，例如 我的聊天客户端，选择你要使用的分组并设置适当额度。

保存后复制完整密钥。具体操作见 创建 API 密钥。

先分清两种凭证

调用模型使用「API 密钥」页面创建的密钥。个人资料中的「访问令牌」用于账户管理接口，不要填进聊天客户端。

3. 连接客户端或代码

准备好这三项信息：

配置项	填写内容
API 地址 / Base URL	https://guangjiapi.top/v1，适用于要求完整 OpenAI 兼容基础地址的工具
API Key / API 密钥	上一步创建的完整密钥
模型 / Model	从光迹 API 模型广场复制的模型 ID

不同软件可能自动补齐 /v1，填写前请看 接入地址怎么填。

• 使用聊天软件：跟随 Cherry Studio 接入教程。
• 配置编程工具：使用 CC Switch 一键导入图文教程。
• 通过代码调用：打开 API 调用示例，选择 cURL、Python、JavaScript 或 PowerShell。

4. 发送一条测试消息

选好模型后，发送一句简单的话，例如「你好，请用一句话介绍自己」。收到回复后，到控制台的使用日志里查看这次请求的模型和消耗。

测试请求也可能产生费用

模型调用按当前平台规则计费。先确认模型价格，再进行少量测试。

如果没有收到回复，保留完整错误信息，按 错误排查 逐项检查；仍无法解决时可 联系 QQ 智能客服。