Documentation / v1

接入文档

沿用 OpenAI SDK 与请求格式,只替换 Base URL、API Key 和模型名称。

https://api.9991314.xyz/v1

快速开始

登录控制台后创建 API Key。密钥只会完整显示一次,请保存在服务端环境变量中。

安全提示:不要把 API Key 写入浏览器前端、公开仓库、截图或客户端安装包。

基础地址

OPENAI_BASE_URL=https://api.9991314.xyz/v1
OPENAI_API_KEY=your_api_key

模型选择

模型可用范围以控制台当前展示为准。你也可以通过兼容接口查询账户可用模型。

查询可用模型

curl https://api.9991314.xyz/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

cURL 示例

curl https://api.9991314.xyz/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

流式输出

在请求体中加入 "stream": true,客户端即可按数据流逐段接收响应。

Python 示例

安装 SDK

pip install openai

发送请求

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://api.9991314.xyz/v1",
)

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

Node.js 示例

安装 SDK

npm install openai

发送请求

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://api.9991314.xyz/v1",
});

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

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

常见问题

401 或未授权

确认请求头格式为 Authorization: Bearer YOUR_API_KEY,并检查令牌是否有效。

模型不存在或无可用渠道

从控制台或 /v1/models 获取当前可用名称,不要直接猜测模型标识。

余额不足或价格未配置

查看控制台额度与模型信息;仍无法确认时,携带请求时间和错误信息联系管理员。

请求超时

适当提高客户端读取超时;长响应建议启用流式输出,并保留请求日志用于定位。