灵息 API 介绍
灵息 API 是灵息 AI 平台为开发者提供的核心服务,旨在以极低廉的成本提供最前沿的 AI 模型推理能力。
避坑指南:90% 的连接问题都源于此!
在开始调试前,请务必进行“DNA 级别”的对照检查:
🚨 核心原则:永远选择 OpenAI 格式
灵息 AI 的所有接口均采用 标准 OpenAI 兼容格式。 无论你调用的是 Gemini、Claude、DeepSeek 还是 Llama,在任何第三方软件或代码中:
- 服务商/接口类型:必须选择 OpenAI。
- API 地址 (Base URL):必须填写下方列出的标准节点地址。
- 不要在 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. 开发者生态
我们为开发者提供了全套的支持工具和文档:
- API 测试场: 交互式 API 调试工具,支持流式响应、参数微调与自定义参数。
- 获取 API 密钥: 了解如何获取您的专属授权密钥。
- 模型名获取工具: 实时查询属于您账号的可用模型 ID。
- 模型详细介绍: 深入了解官方渠道与逆向渠道的区别。
- API 教程: 包含发起对话、流式输出、工具调用等完整示例。
4. 快速上手步骤
- 获取密钥: 在灵息 AI 平台设置页面生成您的 API Key。
- 查询模型: 使用模型名获取器获取您想使用的
model id。 - 发起请求: 使用您熟悉的编程语言,将 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