Developer Documentation

API 接入文档

使用 OpenAI 兼容接口,快速连接平台已启用的大模型。

接口概览

平台提供兼容 OpenAI 的 Chat Completions 接口。大多数已经使用 OpenAI SDK 的项目,只需修改 API Key、Base URL 和模型名称即可迁移。

Base URLhttps://ai-api.site/v1
Chat CompletionsPOST /v1/chat/completions

身份验证

所有 API 请求都需要在 HTTP Header 中携带 Bearer Token。请先在控制台创建 API Key。

Authorization: Bearer sk-your-api-key
Content-Type: application/json

请求参数

modelstring · 必填

要调用的模型标识,可在价目表中查看。

messagesarray · 必填

对话消息数组,包含 role 与 content。

streamboolean · 可选

是否使用流式响应,默认为 false。

temperaturenumber · 可选

控制输出随机性,支持范围以具体模型为准。

cURL 示例

curl https://ai-api.site/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Python 示例

安装官方 OpenAI SDK:pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://ai-api.site/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

print(response.choices[0].message.content)

Node.js 示例

安装官方 OpenAI SDK:npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://ai-api.site/v1"
});

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

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

选择模型

请求中的 model 必须填写平台当前启用的模型标识。不同模型在能力、速度和价格方面有所差异。

查看模型价目表

密钥安全

不要在浏览器或公开代码中暴露 API Key

建议将密钥存放在服务端环境变量中。如果密钥意外泄露,请立即在控制台删除并重新创建。