API 接入文档

灵链 API 完全兼容 OpenAI API 协议，您只需修改 base_url 即可。以下文档帮助您快速集成。

概述

灵链 API 是一个 AI 模型聚合平台，通过统一的接口提供多种主流大语言模型的访问能力。所有请求通过 https://linglianapi.cn/v1/ 转发，兼容 OpenAI 的请求格式。

💡 提示：无需科学上网，国内网络即可直接调用。

3 分钟快速接入

第 1 步：获取 API Key

登录管理后台，在「API Key」页面创建新的密钥。创建后复制保存——密钥仅创建时可见一次。

第 2 步：配置 Base URL

在您的应用中，将 API Base URL 修改为以下地址：

BASE_URL = "https://linglianapi.cn/v1"

第 3 步：开始调用

使用您的 API Key 和 Base URL，像调用官方 API 一样使用即可。以下提供多种语言的示例。

鉴权方式

使用 Bearer Token 鉴权，在请求头中传入：

Authorization: Bearer sk-你的灵链API Key

Python 示例

使用 OpenAI 官方 Python SDK：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的灵链API Key",
    base_url="https://linglianapi.cn/v1"
)

# 对话补全
response = client.chat.completions.create(
    model="deepseek-v4",
    messages=[
        {"role": "system", "content": "你是一个专业助手"},
        {"role": "user", "content": "你好"}
    ],
    temperature=0.7,
    max_tokens=2000
)

print(response.choices[0].message.content)

Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "sk-你的灵链API Key",
    baseURL: "https://linglianapi.cn/v1",
});

const response = await client.chat.completions.create({
    model: "deepseek-v4",
    messages: [{ role: "user", content: "你好" }],
});

console.log(response.choices[0].message.content);

cURL 示例

curl https://linglianapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的灵链API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4",
    "messages": [{"role": "user", "content": "你好"}],
    "temperature": 0.7
  }'

对话补全 API

POST https://linglianapi.cn/v1/chat/completions

完全兼容 OpenAI Chat Completions API 格式。支持的参数：

model (string, 必填) — 模型名称
messages (array, 必填) — 消息列表
temperature (number, 可选) — 采样温度 0-2，默认 1
max_tokens (number, 可选) — 最大输出 Token 数
stream (boolean, 可选) — 是否流式输出
top_p (number, 可选) — 核采样

模型列表

查询可用模型：

curl https://linglianapi.cn/v1/models \
  -H "Authorization: Bearer sk-你的灵链API Key"

也可直接在管理后台查看已接入的模型。

错误处理

API 返回标准的 HTTP 状态码：

200 — 请求成功
400 — 请求参数错误
401 — API Key 无效或未提供
403 — 余额不足或无权限
429 — 请求频率过高
500 — 服务器内部错误

错误响应体：{"error": {"message": "错误描述", "type": "错误类型"}}