AI API Online

接口文档

这是部署在服务器上的 OpenAI 兼容接口。文档、管理页和用量看板已挂在同一个域名下;浏览器保存一套账号密码后,可以在管理和看板之间直接切换。

统一入口

API Base URL http://aiapi.bigeyescc.com

用于程序调用,兼容 OpenAI Chat Completions。

管理页 http://aiapi.bigeyescc.com/admin

更新凭证、查看账户和本地 key 配置。

用量看板 http://aiapi.bigeyescc.com/usage

查看 token、费用、请求历史和子 key 用量。

登录

网页管理入口统一使用同一套账号密码。浏览器弹出登录框时,输入凭证文件里的 Nginx Basic Auth user 和 Unified password。进入管理页或看板后,如果页面再次要求密码,也使用同一个 Unified password。

API 调用不使用网页账号密码,而是使用 Bearer API Key。这样程序调用和网页管理互不混淆。

API 鉴权

所有 API 请求都需要在请求头携带你分配到的 API Key。不要把 key 写进前端公开代码,也不要提交到 Git 仓库。

Authorization: Bearer YOUR_API_KEY

接口

方法 路径 用途
GET /healthz 健康检查。
GET /v1/models 查看当前可用模型。
POST /v1/chat/completions 聊天补全接口,兼容 OpenAI SDK。

请求示例

curl

curl http://aiapi.bigeyescc.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "只回复 OK"}
    ],
    "max_tokens": 100
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="http://aiapi.bigeyescc.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "写一句中文欢迎语"}],
)

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

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AI_API_KEY,
  baseURL: "http://aiapi.bigeyescc.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "写一句中文欢迎语" }],
});

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

模型

当前服务已验证可返回模型列表。实际可用模型以 /v1/models 返回为准。

模型 建议用途
gpt-5.4-mini日常批量聊天、低成本任务。
gpt-5.4更强质量和复杂任务。
gpt-5.5更高质量任务,建议低并发。
gpt-5.3-codex-spark代码类任务。
codex-auto-review代码审查类任务。
gpt-image-1.5 / gpt-image-2图片相关任务。

用量和费用

请求成功后,token 和费用会进入 Usage Keeper。当前价格配置为官方单价基准并乘以 0.30,用于估算中转水平成本。

建议全局并发从 1 到 2 开始,高价模型或 Codex 类模型保持单并发。遇到 429、登录异常或长时间失败时先暂停。

状态

服务器侧包含三个独立服务:mihomo-aiapi.service、cliproxyapi-online.service、cpa-usage-keeper-online.service。

当前页面不展示任何密钥。API Key、管理密码和看板密码请从本地凭证文件读取。