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 userUnified 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.servicecliproxyapi-online.servicecpa-usage-keeper-online.service

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