灵息 API 介绍

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

避坑指南：90% 的连接问题都源于此！

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

1. API 地址 (Base URL) —— 差一个字符都不行

• ✅ 唯一正确：https://ask.ling.rest/api/v1
• ❌ https://ask.ling.rest (少了 /api/v1 核心路径)
• ❌ https://ask.ling.rest/api/v1/ (结尾严禁多出斜杠 /)
• ❌ http://... (必须使用安全加密的 HTTPS)

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	https://ask.ling.rest/api/v1
鉴权方式	Bearer Token (API Key)
格式标准	兼容 OpenAI Chat Completions v1

3. 开发者生态

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

• API 测试场: 交互式 API 调试工具，支持流式响应、参数微调与自定义参数。
• 获取 API 密钥: 了解如何获取您的专属授权密钥。
• 模型名获取工具: 实时查询属于您账号的可用模型 ID。
• 模型详细介绍: 深入了解官方渠道与逆向渠道的区别。
• API 教程: 包含发起对话、流式输出、工具调用等完整示例。

4. 快速上手步骤

1. 获取密钥: 在灵息 AI 平台设置页面生成您的 API Key。
2. 查询模型: 使用模型名获取器获取您想使用的 model id。
3. 发起请求: 使用您熟悉的编程语言，将 Base URL 指向灵息地址即可。

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