Provider 配置

配置 AiApiy 反代

一份 Key 接 OpenAI / Anthropic / Gemini — 在国内访问稳。

AiApiy 是什么

AiApiy 是一个 路由聚合器:它把 OpenAI / Anthropic / Google Gemini / xAI 等十几家上游模型的 API 统一成一个 OpenAI-Responses 兼容的端点。一份 Key、一个 baseURL,就能在 Kition 里访问全部主流模型。

主要用途有两个:一是在国内 / 跨国网络环境下提供稳定低延迟的接入点(直连官方 API 经常超时);二是开发者只想维护一张账单、一份 Key。Kition 与 AiApiy 没有任何商业绑定 — 它只是众多 OpenAI-compatible 路由器中支持得最好的一个。

生成 Key 与查 baseURL

  • 登录 AiApiy 控制台 → API Keys → New Key
  • baseURL 通常是 https://api.aiapiy.com/v1(看你的部署区域可能是 .cn 或区域子域)
  • 充值或绑定 Stripe — AiApiy 是预付费模型
  • Models 页查可用的 model 别名(如 gpt-5.1claude-opus-4-7gemini-2.5-pro

Kition 里添加

走自定义 Provider 模板。注意 wire 选 responses — AiApiy 即使转发到 Anthropic 上游,对外暴露的也是 OpenAI Responses 形状。

{
  "name": "aiapiy",
  "baseURL": "https://api.aiapiy.com/v1",
  "apiKey": "ak-...",
  "wire": "responses",
  "defaultModel": "claude-sonnet-4-6"
}

认证 header

AiApiy 沿用 OpenAI 的 Authorization: Bearer <key>,无需额外 header。如果你的部署用了私有 baseURL,把它原样填到 Provider 里即可 — Kition 不会做任何路径改写。

curl https://api.aiapiy.com/v1/responses \
  -H "Authorization: Bearer $AIAPIY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","input":"ping"}'

模型路由表

AiApiy 用别名把不同上游统一到 OpenAI 形状。下面是常见映射 — 实际可用列表以控制台 Models 页为准。

  • gpt-5.1 / gpt-5 — 转发 OpenAI 官方
  • claude-opus-4-7 / claude-sonnet-4-6 — 转发 Anthropic
  • gemini-2.5-pro / gemini-2.5-flash — 转发 Google
  • grok-4 — 转发 xAI
  • 部分上游模型有 -thinking 后缀启用 reasoning,看控制台说明

常见错误

  • 401 Unauthorized — Key 拼写错 / 已暂停 / 余额耗尽
  • 402 Payment Required — 账户余额为零,先充值
  • 404 model not found — 模型别名写错或上游下线
  • 429 too many requests — AiApiy 侧或上游侧限速;自动重试
  • 502 Bad Gateway — 上游短暂故障,通常 30 秒内恢复
  • 响应 streaming 卡顿 — 排查本地代理 / DNS,AiApiy 端点本身是 SSE

何时该用

推荐场景:身在中国大陆 / 公司网络封锁直连官方 API / 需要在一份账单上多模型对比。

不推荐场景:你已经有 OpenAI 或 Anthropic 直连账号且网络稳 — 直连永远比经过中间层延迟低、更便宜。

相关文档

下载 Kition

本地优先的 AI 工作空间。Markdown 文档、结构化数据表、AI Agent,全部跑在你自己的电脑上。