常见问题启玥 API 使用教程
这里汇总启玥 API 接入各类工具时最常见的问题。配置失败时，建议先按本页逐项检查。
Q：API 请求失败怎么办？
优先检查下面几项：
- API Key 是否复制完整。
- 请求地址是否填写正确。
- 账户余额是否充足。
- 模型名称是否是平台当前支持的模型。
- 工具里选择的供应商或模型是否已经启用。
- API Key 是否复制完整。
- 请求地址是否填写正确。
- 账户余额是否充足。
- 模型名称是否是平台当前支持的模型。
- 工具里选择的供应商或模型是否已经启用。
Q：API Key 应该填在哪里？
API Key 一般填到工具里的“API Key”“密钥”或认证字段对应位置。
常见格式如下：sk-...
常见格式如下：sk-...
警告：不要把 API Key 填进请求地址，也不要把真实 Key 发到聊天、截图、文章或代码仓库里。
Q：请求地址应该怎么填？
不同工具要求略有不同：
https://api.qiyue999.top
部分兼容接口工具需要填写：
https://api.qiyue999.top/v1
如果工具会自己拼接后续路径，请按教程要求不要在末尾额外添加 /。
https://api.qiyue999.top
部分兼容接口工具需要填写：
https://api.qiyue999.top/v1
如果工具会自己拼接后续路径，请按教程要求不要在末尾额外添加 /。
Q：模型列表获取不到怎么办？
可以按下面顺序排查：
- 确认 API Key 有效且余额充足。
- 确认请求地址没有写错。
- 确认工具使用的是兼容接口或对应教程里的接入方式。
- 如果使用中转面板，确认当前供应商已经保存并启用。
- 确认 API Key 有效且余额充足。
- 确认请求地址没有写错。
- 确认工具使用的是兼容接口或对应教程里的接入方式。
- 如果使用中转面板，确认当前供应商已经保存并启用。
Q：/model 里看不到模型怎么办？
在各类中转面板工具中，界面显示的模型名和实际请求模型可能不是同一个字段。
请检查：
- “显示名称”是否填写。
- “实际请求模型”是否填写为平台支持的模型名。
- 是否点击保存，并在工具中切换到了刚配置的供应商。
请检查：
- “显示名称”是否填写。
- “实际请求模型”是否填写为平台支持的模型名。
- 是否点击保存，并在工具中切换到了刚配置的供应商。
Q：请求地址末尾能不能带 /？
一般建议不要带，尤其是中转面板工具中复制主域名时。
推荐：https://api.qiyue999.top
不推荐：https://api.qiyue999.top/
部分兼容接口配置需要 /v1，则按对应教程填写：
https://api.qiyue999.top/v1
推荐：https://api.qiyue999.top
不推荐：https://api.qiyue999.top/
部分兼容接口配置需要 /v1，则按对应教程填写：
https://api.qiyue999.top/v1
Q：图像生成模型不可用怎么办？
先确认模型列表中是否能看到对应图像模型。
如果看不到，优先检查密钥、接口地址、客户端依赖安装情况，以及账户是否有可用额度。
如果看不到，优先检查密钥、接口地址、客户端依赖安装情况，以及账户是否有可用额度。
Q：配置完成后还是不能用怎么办？
建议先重启相关工具或中转面板。
如果仍然失败，记录下面信息后再排查：
- 使用的工具名称和版本。
- 填写的请求地址。
- 选择的模型名。
- 报错截图或错误文本。
- 当前账户余额是否充足。
如果仍然失败，记录下面信息后再排查：
- 使用的工具名称和版本。
- 填写的请求地址。
- 选择的模型名。
- 报错截图或错误文本。
- 当前账户余额是否充足。