开发者文档

灵枢 API 接入指南

接口兼容 OpenAI Chat Completions。创建灵枢 API Key 后,只需修改 Base URL 和 Key。

Base URL:

快速接入

  1. 登录灵枢 AI,进入「API 控制台」。
  2. 创建 API Key,并立即保存完整密钥。
  3. 选择模型广场中已上架的模型 ID。
  4. 使用下方示例发送请求。

鉴权

在请求头中携带 Bearer Token:

Authorization: Bearer ls-your-api-key

模型列表

curl /models \
  -H "Authorization: Bearer ls-your-api-key"

聊天接口

curl /chat/completions \
  -H "Authorization: Bearer ls-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lingshu-demo",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "stream": false
  }'

流式输出

stream 设为 true,接口返回标准 SSE 数据流。

{
  "model": "lingshu-demo",
  "messages": [{"role":"user","content":"写一个标题"}],
  "stream": true
}

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="ls-your-api-key",
    base_url=""
)

response = client.chat.completions.create(
    model="lingshu-demo",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

Node.js SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ls-your-api-key",
  baseURL: ""
});

const result = await client.chat.completions.create({
  model: "lingshu-demo",
  messages: [{ role: "user", content: "你好" }]
});
console.log(result.choices[0].message.content);

常见错误

HTTP含义处理方式
401API Key 无效重新创建或启用密钥
402余额不足提交充值订单
404模型未配置检查模型 ID 或联系管理员
429调用频率过高降低并发并增加重试
502上游调用失败检查上游余额、模型权限和 Base URL