灵息 AI 文档

Appearance

API ​

获取 API 密钥 ​

要使用 问.灵息 的开放 API，您必须先获取一个 API 密钥。请前往：设置 > 账号 > API 密钥 获取您的密钥。

请务必妥善保管该密钥，避免泄露给他人；密钥一旦泄露，任何人都可以在您的额度范围内调用接口并产生消耗。

image_20251220172303.png

Base URL 选择 ​

问.灵息 提供两个等价的 Base URL，接口与功能完全一致，差别仅在于访问域名与网络路径。您可以根据自身网络环境与稳定性偏好选择其一：

选择建议：

  • 如果您在本地网络环境下访问 问.灵息.com 更快更稳，就选它
  • 如果您访问 chat.breathai.top 更快更稳，就选它
  • 两个地址可以随时切换，返回结构与模型能力一致

第一步：先获取模型列表（必须做） ​

在调用任何模型前，您必须先拉取一次“可用模型列表”，原因很简单：

  • 平台前端显示的“模型名称”不一定等于真实后端模型标识
  • API 调用必须使用 后端模型 ID（model id）
  • 不同用户组（Default/Plus/Pro 等）可见模型可能不同，直接复制别人代码容易报错
  • 平台会持续更新模型与别名，以实时接口返回为准最稳 因此，第一步必须先调用 GET /models，拿到属于您账号的正确 model id。

示例：获取全部模型（Python） ​

下面这段代码会请求您的模型列表，并打印每个模型的 id 和 name（若存在）。

请先把 BASE_URL 和 API_KEY 替换成您自己的。

python
import requests

BASE_URL = "https://问.灵息.com/api/v1"  # 或 https://chat.breathai.top/api/v1
API_KEY = "YOUR_API_KEY_HERE"

resp = requests.get(
    f"{BASE_URL}/models",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=30,
)

resp.raise_for_status()
data = resp.json()

# OpenAI 兼容格式通常为: {"object":"list","data":[{"id":"...","object":"model",...}, ...]}
models = data.get("data", [])

print(f"Total models: {len(models)}\n")
for m in models:
    mid = m.get("id", "")
    name = m.get("name", "") or m.get("display_name", "")
    if name:
        print(f"{mid}  |  {name}")
    else:
        print(mid)

示例：获取全部模型（Node.js / JavaScript） ​

javascript
const BASE_URL = "https://问.灵息.com/api/v1"; // 或 https://chat.breathai.top/api/v1
const API_KEY = "YOUR_API_KEY_HERE";

async function main() {
  const res = await fetch(`${BASE_URL}/models`, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
  });

  if (!res.ok) {
    const text = await res.text();
    throw new Error(`HTTP ${res.status}: ${text}`);
  }

  const data = await res.json();
  const models = data.data || [];

  console.log(`Total models: ${models.length}\n`);
  for (const m of models) {
    const id = m.id || "";
    const name = m.name || m.display_name || "";
    console.log(name ? `${id}  |  ${name}` : id);
  }
}

main().catch(console.error);

如何使用获取到的模型 ID ​

当您从 /models 拿到目标模型的 id 后，就可以把它填入后续请求的 model 字段中进行调用。

例如（OpenAI 兼容 Chat Completions 风格）：

  • 接口：POST {BASE_URL}/chat/completions
  • body 中关键字段：model: "<你从 /models 里拿到的 id>"

注意：不同模型支持的能力不同（纯文本 / 视觉 / 多模态 / 深度推理等）。 是否支持图像、音频或推理模式，以您 /models 返回的可用信息以及平台标注为准。

常见问题 ​

1）为什么我能在网页里看到某个模型，但 API 调用报 “model not found”？ ​

通常是因为：

  • 您使用了“前端展示名”而非后端 id
  • 您的账号权限组不包含该模型的 API 调用权限
  • 您复制了别人的 model id，但对方的可见模型与你不同 解决方式：以您自己的 /models 返回为准，重新选择正确 id。

2）两个 Base URL 会影响模型列表吗？ ​

不会。两个 Base URL 对应同一套 API 能力与账号体系。模型列表由您的账号权限决定，与使用哪个 Base URL 无关。

3）密钥泄露了怎么办？ ​

如果您怀疑密钥已经泄露，请立即在 设置 > 账号 > API 密钥 处重新生成或更换密钥，并停止使用旧密钥。