Skip to content

灵息 API 介绍 ​

灵息 API 是灵息 AI 平台为开发者提供的核心服务,旨在以极低廉的成本提供最前沿的 AI 模型推理能力。

避坑指南:90% 的连接问题都源于此!

在开始调试前,请务必进行“DNA 级别”的对照检查:

🚨 核心原则:永远选择 OpenAI 格式 ​

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

  1. 服务商/接口类型:必须选择 OpenAI。
  2. API 地址 (Base URL):必须填写下方列出的标准节点地址。
  3. 不要在 API 地址中混入模型名(例如:https://ask.ling.rest/api/v1/gemini-2.5-flash 是错误的)。

1. API 地址 (Base URL) & 节点选择 ​

灵息 AI 提供多个接入节点,请根据您的网络环境选择最合适的 Base URL:

  • 普通节点 (推荐): 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

提示

如果您在某些网络环境下访问较慢,可以尝试切换不同的网络连接。 所有节点的 API 功能完全一致,仅网络接入线路不同。

2. 模型 ID —— 计算机只认机械式拼写 ​

  • ✅ 唯一正确:gemini-3-flash-preview-vertex (全小写 + 横杠连接)
  • ❌ Gemini 3 Flash (带空格或大写)
  • ❌ gemini_3_flash (使用了下划线)
  • ❌ Gemini-3-Flash... (首字母大写)
  • ❌ gemini-3 (自作聪明缩写)

金律:报错时先对着这两条逐字符打钩检查。如果你能保证这两项 100% 准确,90% 的问题将不攻自破。 :::

1. 核心优势 ​

  • 极速推理: 包含基于 Groq LPU 推理的超高速模型,响应时间低至毫秒级。
  • 超低价格: 提供极其低廉甚至免费的推理价格,大幅降低开发者的接入门槛。
  • 全模型支持: 覆盖从官方企业级模型(Vertex AI, AI Studio)到高性能逆向模型的全矩阵。
  • OpenAI 兼容: 采用标准的 OpenAI API 格式,您可以直接使用现有的 OpenAI SDK 或工具(如 ChatGPT Next Web, One API 等)无缝切换。
  • 成人模型支持: 提供无限制的成人内容创作模型,且已内置优化提示词。

2. 接口信息 ​

项目内容
Base URL见上文 节点选择
鉴权方式Bearer Token (API Key)
格式标准兼容 OpenAI Chat Completions v1

3. 开发者生态 ​

我们为开发者提供了全套的支持工具和文档:

4. 快速上手步骤 ​

  1. 获取密钥: 在灵息 AI 平台设置页面生成您的 API Key。
  2. 查询模型: 使用模型名获取器获取您想使用的 model id。
  3. 发起请求: 使用您熟悉的编程语言,将 Base URL 指向灵息地址即可。
bash
curl https://ask.ling.rest/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gemini-1.5-flash",
    "messages": [{"role": "user", "content": "你好,灵息!"}]
  }'

5. 开发者承诺 ​

灵息 AI 致力于打造一个开放、自由且高性能的 AI 推理环境。我们将持续更新最新的前沿模型(如 GPT-5.2、Claude 4.5 预研版等),并在保证稳定性的前提下不断下调开发者成本。

有问题?欢迎加入灵息 AI QQ 群:180522359