玖亿 API
API 开发接入

API 开发接入

玖亿 API 提供 OpenAI 兼容接口。把 API Key 放在服务端环境变量中,将 SDK 的 base_url 指向 https://api.9e.lv/v1,再使用模型广场中当前令牌分组支持的完整模型 ID。

模型、协议、计费倍率和并发规则会持续调整。以下示例使用占位符,实际值请以控制台模型广场为准。

地址与鉴权

用途地址
服务主地址https://api.9e.lv
OpenAI 兼容 Base URLhttps://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 openai
import 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 openai
import 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
}

下一步:查看 模型与令牌,或按客户端进入 CLI 配置