API 开发接入
玖亿 API 提供 OpenAI 兼容接口。把 API Key 放在服务端环境变量中,将 SDK 的 base_url 指向 https://api.9e.lv/v1,再使用模型广场中当前令牌分组支持的完整模型 ID。
模型、协议、计费倍率和并发规则会持续调整。以下示例使用占位符,实际值请以控制台模型广场为准。
地址与鉴权
| 用途 | 地址 |
|---|---|
| 服务主地址 | https://api.9e.lv |
| OpenAI 兼容 Base URL | https://api.9e.lv/v1 |
| 模型列表 | GET /v1/models |
| 对话接口 | POST /v1/chat/completions |
| Responses 接口 | POST /v1/responses(目标模型支持时使用) |
每次请求都要带鉴权头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json不要把完整 API Key 写进前端代码、提交到仓库,或放在截图中。
先验证地址和令牌
export JIUYI_API_KEY='替换为你的 API Key'
curl https://api.9e.lv/v1/models \\
-H "Authorization: Bearer $JIUYI_API_KEY"能够返回模型列表,说明地址和鉴权已连通。若返回 401,先检查令牌是否完整、有效且属于当前模型分组。
最小对话请求
curl https://api.9e.lv/v1/chat/completions \\
-H "Authorization: Bearer $JIUYI_API_KEY" \\
-H "Content-Type: application/json" \\
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "请回复:连接成功"}]
}'将 YOUR_MODEL_ID 替换为模型广场显示的完整 ID。模型展示名、简称或其他平台的别名不一定能调用。
Python
先安装官方 OpenAI Python SDK:
pip install openaiimport os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["JIUYI_API_KEY"],
base_url="https://api.9e.lv/v1",
)
response = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[{"role": "user", "content": "请回复:连接成功"}],
)
print(response.choices[0].message.content)Node.js
npm install openaiimport OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.JIUYI_API_KEY,
baseURL: "https://api.9e.lv/v1",
});
const response = await client.chat.completions.create({
model: "YOUR_MODEL_ID",
messages: [{ role: "user", content: "请回复:连接成功" }],
});
console.log(response.choices[0].message.content);流式返回
在支持流式的模型和分组中加入 stream: true。客户端需要按 SSE 增量读取 data 事件,并处理连接中断;不同模型的工具调用、视觉和 JSON 参数支持可能不同。
{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "写一句欢迎语"}],
"stream": true
}