Kaoya AI API 文档
控制台 免费注册
Kaoya AI Docs

从一枚独立密钥开始

管理员账号只负责管理。日常调用请使用普通用户创建的 API Key，并为每个人、每个工具分别创建密钥。

推荐做法 你自己也注册一个普通用户账号，按需分配额度和分组。不要把管理员密码或管理员 Key 填进日常工具。
01 / API KEY

创建 API Key

  1. 登录普通用户账号打开控制台，进入左侧“API 密钥”。
  2. 点击创建密钥填写容易辨认的名称，例如“我的 Codex”或“朋友-A”。
  3. 选择分组不同分组对应不同模型池；专属分组需要管理员先授权。
  4. 立即保存完整密钥通常只显示一次，不要发到群聊、截图或公开仓库。
余额为 0 时无法调用 新注册用户默认没有可用余额，需要管理员在“用户管理”中分配余额后才能发起请求。
02 / ENDPOINT

接口地址

多数 OpenAI 兼容客户端填写带 /v1 的 Base URL；Claude Code 则填写不带 /v1 的站点根地址。

OpenAI Base URLhttps://ai.kaoyaai.top/v1
Claude Base URLhttps://ai.kaoyaai.top
Gemini Base URLhttps://ai.kaoyaai.top/v1beta
OpenAI · Responses

Responses API

Codex 和新式 OpenAI 客户端优先使用此接口。把 YOUR_API_KEY 换成普通用户创建的密钥。

cURL
curl https://ai.kaoyaai.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "你好，请只回复 OK"
  }'
OpenAI · Chat Completions

Chat Completions

适合 Cherry Studio、ChatBox 和支持 OpenAI 兼容格式的常用客户端。

cURL
curl https://ai.kaoyaai.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'
Python · OpenAI SDK
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://ai.kaoyaai.top/v1",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)
Anthropic · Messages

Claude Messages

创建绑定 Claude 分组的 API Key，再调用 Anthropic Messages 接口。

cURL
curl https://ai.kaoyaai.top/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Claude Code（PowerShell）

$env:ANTHROPIC_BASE_URL="https://ai.kaoyaai.top"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude
Google · Gemini

Gemini 原生接口

Gemini 当前是专属分组。管理员授权后，用户才能创建对应密钥并看到该渠道。

cURL
curl "https://ai.kaoyaai.top/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "你好"}]}]
  }'
03 / CLIENTS

客户端怎么填

Codex / Responses

Base URL 填 https://ai.kaoyaai.top/v1，协议选择 Responses，模型按“可用渠道”页面填写。

Cherry Studio

提供商选择 OpenAI 兼容，填入 Base URL 和独立 API Key，然后手动添加模型名称。

Claude Code

使用站点根地址作为 ANTHROPIC_BASE_URL，API Key 作为 ANTHROPIC_AUTH_TOKEN。

其他客户端

只要支持自定义 OpenAI、Anthropic 或 Gemini 地址，通常都可以接入。

04 / MODELS

查看可用模型

登录控制台后打开“可用渠道”，查看当前账号能访问的渠道、模型和分组。页面展示会根据专属授权自动过滤。

查看可用渠道 ↗
05 / HELP

常见错误

401 密钥无效+

检查 Key 是否复制完整、是否被删除，以及请求头是否使用正确的认证格式。

403 无权使用分组+

该 Key 没有绑定对应分组，或用户尚未获得专属分组授权。

402 / 余额不足+

联系管理员分配余额；新注册账号默认余额为 0。

429 请求过快+

降低并发和请求频率，稍后重试。普通新用户默认并发为 1。

准备好后，从控制台创建第一枚 Key。

进入控制台 ↗
已复制