Skip to content

常见问题与错误排查 (FAQ) ​

这里汇总了在使用灵息 AI 过程中,用户(尤其是新手)最常遇到的问题与错误配置。

🚨 原则:永远选择 OpenAI 格式

灵息 AI 的所有接口均采用 标准 OpenAI 兼容格式。 无论你调用的是 Gemini、Claude、DeepSeek 还是 Llama,在任何第三方软件或代码中:

  1. 服务商/接口类型:必须选择 OpenAI。
  2. API 地址 (Base URL):必须填写下方列出的标准节点地址。
  3. 不要在 API 地址中混入模型名。

1. ⚠️ API 地址配置错误(最常见) ​

很多新手会将模型 ID 或具体路径直接拼接到 API 地址后面,这是错误的。

❌ 错误配置示例: ​

  • https://ask.ling.rest/api/v1/chat/completions/gemini-2.5-flash ❌
  • https://ask.ling.rest/chat/gemini-2.5-flash ❌
  • https://ask.ling.rest/?model-gemini-2.5-flash ❌
  • http://ask.ling.rest/api/v1 (缺少 s,不支持 http) ❌
  • https://ask.ling.rest/api/v1/ (末尾多了斜杠) ❌
  • https://ask.ling.rest/v1 (缺少 /api) ❌
  • http://ask.ling.rest/v1/api (api和v1搞反) ❌

✅ 正确配置示例: ​

  • https://ask.ling.rest/api/v1/chat/completions
  • https://ask.ling.rest/api/v1
  • https://ask.ling.rest/api

灵息 AI 提供多个接入节点,请根据您的网络环境选择其一:

  • 普通节点 (推荐): https://ask.ling.rest/api/v1
  • 中国节点 (大陆极速): https://breath.hujiarong.site/api/v1
  • CF 节点 (全球加速): https://ask-cf.ling.rest/api/v1
  • 优选节点 (进阶体验): https://ask-saas.ling.rest/api/v1

注意:如果软件要求填写的字段名是 Endpoint 或 Base URL,请填入上述地址。如果软件自动补全了 /chat/completions,请确保你填入的地址末尾没有多余的路径。


2. 🤖 模型调用问题 ​

模型名字在哪里看? ​

为了保证模型调用的准确性,请务必使用我们的 模型名获取器 来获取最新的模型 ID。

  • 必须全小写,格式必须完全一致(如 gemini-3-flash-preview-vertex)。
  • 不要随意猜测或使用前端显示的“漂亮名字”。

为什么模型回复很慢或报错? ​

  • 逆向模型 (Reverse):此类模型虽然价格极低,但不保证稳定性。出现响应慢、空回复、偶发报错属于正常现象。
  • 稳定性优先:如果您对稳定性有极高要求,请务必选择官方渠道模型(如 Vertex、AI Studio、OpenAI 或 Anthropic 系列)。

3. 🛠️ HTTP 状态码排查 ​

状态码含义解决办法
401Unauthorized (身份验证失败)检查 API Key 是否正确填写,是否带了 Bearer 前缀,或 Key 是否已失效。
403Forbidden (权限不足)您的账号权限组可能不包含该模型,请在控制台确认您的套餐。
404Not Found (地址/模型错误)1. 检查 API 地址是否拼写错误;2. 检查模型 ID 是否在获取器列表中。
429Too Many Requests (频率限制)您的请求速度过快或触发了限额,请降低并发或充值余额。
5xxServer Error (服务器错误)通常是上游模型供应商波动。请稍后重试或更换其他模型渠道。

4. 💰 账号与计费 ​

提示“余额不足”怎么办? ​

请前往 灵息 AI 控制台 进行充值。API 调用按量计费,余额为 0 时所有请求都将被拒绝。

如何获取 API 密钥? ​

在控制台的 设置 > API 密钥 页面生成。密钥格式通常为 sk-xxxxxxxxxxxx。


5. 💡 进阶使用建议 ​

  • 流式输出:在请求参数中加入 "stream": true 即可实现类似 ChatGPT 的打字机效果。详见 流式输出教程。
  • 超时设置:建议将客户端的超时时间设置为 60s - 120s,尤其是使用逻辑较强的长文本模型时。

返回首页 | 线路选择 | 开发者工具