接入文档

快速开始

三步就能发出第一个请求。做之前先在控制台建一个 API Key，记下它所属的分组 —— 分组决定倍率和可用模型。

1. 01

   建密钥

   控制台 → API 密钥 → 新建，选一个分组，生成 sk- 开头的 Key。

2. 02

   换地址

   客户端的 API 地址填 https://kittywizards.com/v1，密钥填 Key。

3. 03

   发请求

   模型名填分组里支持的型号，跑通即用。模型清单见 模型列表。

Base URL 填哪里、填什么

为什么不一样：Claude Code 和 Anthropic SDK 会自己往后面拼 /v1/messages，你给的地址要停在根上；OpenAI 兼容客户端只会拼 /chat/completions，所以要你先给到 /v1。多写一个变成 /v1/v1 会 404，少写了会拿到一堆网页 HTML。

线路与备用入口

默认线路走全球 CDN 智能调度。如果遇到卡顿、流式输出断断续续、或频繁连接超时（多发生在晚高峰），把 Base URL 换成下面的备用线路 —— 东京直连，不用代理也快。其余什么都不用动。

鉴权方式

两套协议用两个不同的请求头，但都是同一个 Key。

Key 只显示一次，请立刻保存。怀疑泄露就在控制台撤销，重新建一个 —— 撤销是立即生效的。

OpenAI 兼容

最通用的一路。Cursor、Cherry Studio、各种第三方客户端默认都走这个格式。

curl https://kittywizards.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的key",
    base_url="https://kittywizards.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的key",
  baseURL: "https://kittywizards.com/v1",
});

const res = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好" }],
});
console.log(res.choices[0].message.content);

Anthropic 原生

要用 Claude 的 thinking、cache_control、工具调用这些原生能力，走这一路。

curl https://kittywizards.com/v1/messages \
  -H "x-api-key: sk-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "你好"}]
  }'

流式请求加 "stream": true，返回的是标准 SSE 事件流，跟官方一致。

客户端配置

下面这些是手写配置。如果不想动配置文件，用 桌面客户端 点两下就能完成 —— 它会自己找到 Claude Code 和 Codex 的配置文件，写完还能一键还原。

Claude Code

export ANTHROPIC_BASE_URL="https://kittywizards.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的key"
claude

Codex CLI

编辑 ~/.codex/config.toml：

model_provider = "kittywizards"

[model_providers.kittywizards]
name = "魔法咪"
base_url = "https://kittywizards.com/v1"
env_key = "KW_API_KEY"

Cherry Studio / ChatBox 等图形客户端

新建一个 OpenAI 兼容的供应商，API 地址填 https://kittywizards.com/v1，密钥填 sk-，模型名手动加或者点「拉取模型」。

magpie 本地网关

上面几种都是「填个地址就能用」。但有一类客户端不给你填地址 —— 比如 Claude 官方桌面版，它只认自家服务端；或者你一台机器上同时跑 Claude Code、Codex、Gemini CLI、OpenCode，每家各要一套配置、各记一个 Key。

magpie 是开源的本地网关（MIT 协议，只监听本机 127.0.0.1:3425）。把本站加成它的一个「供应商」，这些客户端就共用同一份 Key 和同一份模型清单，协议差异由网关在本机转换。

加一个供应商

装好 magpie，终端里跑一条命令，把 sk-你的key 换成控制台生成的 Key：

magpie provider add kittywizards \
  url=https://kittywizards.com/v1 \
  anthropic=https://kittywizards.com \
  key=sk-你的key

两个地址的分工和 快速开始 那张表一致：url 给 OpenAI 系用，要带 /v1；anthropic 给 Claude 系用，停在域名根。填反了会报 404，不是 Key 的问题。

拉模型、验证

magpie provider models kittywizards   # 拉取本分组可用的模型
magpie provider test kittywizards     # 探一次连通性
magpie providers                      # 全部供应商一览

让客户端指向网关

magpie 能自动改 Claude Code、Codex 的配置，在它的界面里选个模型就行。不受支持的客户端手动设环境变量：

export OPENAI_BASE_URL="http://127.0.0.1:3425/v1"
export ANTHROPIC_BASE_URL="http://127.0.0.1:3425"
# 这里的 key 随便填，网关只监听本机

桌面客户端

给不想手改配置的人准备的小工具。选中线路、填上 Key、点一下，它就把 Claude Code 和 Codex 的配置写好；想退回去，一键还原到导入前的样子。

下载链接带版本号 ?v=1.0.0，换新版时版本号会变，不会拿到旧的缓存包。

它能做什么

• 管线路：预置本站线路，也能加别的中转站，随时切换。
• 探测可用性：拉一次 /v1/models，通不通一眼看到。
• 一键写配置：自动定位 ~/.claude/settings.json 和 ~/.codex/config.toml，只改它管的字段，你原有的其他设置原样保留。
• 一键还原：写入前自动备份，点还原逐字节回到导入前。
• 只跑一份：重复双击会复用已经开着的窗口，不会起第二个进程。

怎么用

1. 下载后双击运行，浏览器会自动打开本地界面。
2. 选线路（默认就是本站），粘贴你的 sk- Key，点「探测」确认能通。
3. 勾选要写入的客户端（Claude Code / Codex），点导入。
4. 重启对应客户端，配置就生效了。想撤回就点「还原」。

校验下载是否完整

下完后对一下哈希，一致就说明文件没被改动过。

certutil -hashfile kitty-connect.exe SHA256

shasum -a 256 kitty-connect.exe

程序在本地运行，只做一件事：读写那两个配置文件。不采集浏览器数据，不上报使用信息。

模型列表

直接问接口，返回你当前 Key 所在的分组能用的模型：

curl https://kittywizards.com/v1/models \
  -H "Authorization: Bearer sk-你的key"

分组与倍率

实际扣费 = 官方价格 × 分组倍率。不同分组对应不同的上游和定价，建 Key 时选定，之后按该分组计费。

倍率低不等于便宜，取决于上游真实成本。低价档一般有并发与用量限制，跑生产建议选「稳定」或「企业」档。

限流与额度

• RPM：每分钟请求数上限，按分组配置。
• 日 / 周 / 月额度：按美元计的上限，超了直接拒绝，不会偷偷扣费。
• 并发：同时进行的请求数。超了会排队或直接 429。
• 余额：余额不足时请求会被拒，控制台可以看到实时账单。

测试分组通常限得很紧（例如 20 RPM、每日 $1），只适合验证连通性，不适合压测。

错误码

常见问题