入门指南
地址、密钥、模型，准备好这三项。
同一枚 API 密钥，可以在应用、编程工具和自己的代码里使用流光的模型。开始前，只需要准备好下面三项。
| 填写项 | 填写内容 | 说明 |
|---|---|---|
| ① 接口地址 | https://liuguang.ai/v1 | OpenAI 兼容客户端使用这个地址；Claude Code 使用不带 /v1 的站点根地址。 |
| ② API 密钥 | 前往 API 密钥 → 创建密钥 | 复制以 sk-lg- 开头的完整密钥，按需设置额度和分组。 |
| ③ 模型 ID | 前往模型市场选择模型 | 复制精确 ID；也可通过 GET /v1/models 查询。 |
接口格式怎么选？
普通 OpenAI 兼容客户端用 Chat Completions；Claude Code 用 Messages；Codex 用 Responses。Gemini、图片、视频和音频使用各自的上游接口。在左侧展开具体模型，即可查看路径、参数、提交与查询示例。
选择你的接入方式
选择密钥路由
注册成功后，系统会自动创建一枚「默认密钥」，使用「智能路由 → 智能自动」，可在密钥管理中查看和复制。创建或配置 API 密钥时，可使用智能路由，也可单独绑定一个接入分组。控制台新建密钥默认选择「智能自动」；已有密钥保留原有分组或价格优先设置。
| 策略 | 选择依据 | 适用需求 |
|---|---|---|
| 智能自动 | 综合本次预估费用、近期响应速度和成功率 | 平衡费用与调用体验 |
| 价格优先 | 按当前请求参数和账户价格比较预估费用 | 优先控制调用成本 |
| 速度优先 | 优先选择近期响应更快的可用分组 | 更重视响应速度 |
| 成功率优先 | 优先选择近期调用更稳定的可用分组 | 更重视调用稳定性 |
| 指定分组 | 只使用绑定分组，不切换到其他分组 | 固定分组与价格范围 |
路由仅在当前模型和接口支持的分组中选择，不改变模型权限。近期表现数据不足时按价格选择。未绑定分组的密钥仍可通过请求中的 group 或 X-Liuguang-Group 指定分组；已绑定分组的密钥不能请求其他分组。实际费用以调用日志中使用的分组和用量为准。
API 与网页共用账户余额，按实际选择的模型和分组价格计费。第一次调用前，请确认账户有可用余额。