灵枢 API 接入指南
接口兼容 OpenAI Chat Completions。创建灵枢 API Key 后,只需修改 Base URL 和 Key。
Base URL:
快速接入
- 登录灵枢 AI,进入「API 控制台」。
- 创建 API Key,并立即保存完整密钥。
- 选择模型广场中已上架的模型 ID。
- 使用下方示例发送请求。
鉴权
在请求头中携带 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 | 含义 | 处理方式 |
|---|---|---|
| 401 | API Key 无效 | 重新创建或启用密钥 |
| 402 | 余额不足 | 提交充值订单 |
| 404 | 模型未配置 | 检查模型 ID 或联系管理员 |
| 429 | 调用频率过高 | 降低并发并增加重试 |
| 502 | 上游调用失败 | 检查上游余额、模型权限和 Base URL |