文档
先挑你手上的工具,照那一节改两三行配置。API 有自己的地址,和这个网站分开:
https://api.apicabin.ai
Claude Code
在启动 claude 之前设好两个环境变量(macOS / Linux):
export ANTHROPIC_BASE_URL="https://api.apicabin.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_CABIN_KEY"
claude
Windows 上用 PowerShell 这样写:
$env:ANTHROPIC_BASE_URL = "https://api.apicabin.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_CABIN_KEY"
claude
Claude 系列只接受官方 Claude Code(2.1.285 或更新)和 Claude Desktop;别的客户端调 Claude 会被上游拒绝,这种请求不扣费。
Codex
编辑 ~/.codex/config.toml,加一个指向小屋的 provider:
model = "gpt-5.6-sol"
model_provider = "apicabin"
[model_providers.apicabin]
name = "ApiCabin"
base_url = "https://api.apicabin.ai/v1"
env_key = "APICABIN_KEY"
wire_api = "responses" # the cabin speaks the Responses API
再把钥匙放进配置里写的那个环境变量,然后照常运行 codex:
export APICABIN_KEY="YOUR_CABIN_KEY"
codex
Codex 只用 GPT 系列,推荐 gpt-5.6-sol、gpt-6-astra,想省钱可以用 gpt-6.1-sol。
Cursor
- 打开 Cursor Settings,进入 Models 页面。
- 在 OpenAI API Key 一栏粘贴你的小屋钥匙。
- 打开 Override OpenAI Base URL,填入 https://api.apicabin.ai/v1。
- 点 Add model 加上要用的调用名,比如 gpt-5.6-sol 或 qwen3.7-plus,再点 Verify。
Cursor 里只能用 OpenAI 兼容协议的模型;要用 Claude,请换 Claude Code。
Cherry Studio
- 设置 → 模型服务 → 添加,提供商类型选 OpenAI。
- API 地址填 https://api.apicabin.ai,API 密钥填你的小屋钥匙。
- 点「管理」,从拉回来的列表里勾选要用的模型。
- 要用 Gemini,再添加一个类型为 Gemini 的提供商,地址和钥匙不变。
自己写代码
用 OpenAI 官方 Python SDK,只需要改 base_url:
import openai, os # key lives in APICABIN_KEY
cabin = openai.OpenAI(base_url="https://api.apicabin.ai/v1", api_key=os.environ["APICABIN_KEY"])
note = cabin.chat.completions.create(
model="qwen3.7-plus",
messages=[{"role": "user", "content": "Name three things a cabin needs."}],
)
print(note.choices[0].message.content)
Gemini 走它自己的 generateContent 接口:
curl "https://api.apicabin.ai/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: YOUR_CABIN_KEY" -H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Name three things a cabin needs."}]}]}'
能用的 Gemini 调用名:gemini-2.5-flash, gemini-3.1-pro, gemini-3.8-flash, gemini-4-argon
协议参考
| 协议类型 | 路径 | 钥匙放在 | 能调哪些模型 |
|---|---|---|---|
| OpenAI 兼容 | /v1/chat/completions/v1/responses/v1/models | Authorization: Bearer <cabin key> | GPT、Qwen、DeepSeek、Kimi、GLM、Grok、MiniMax、MiMo |
| Anthropic | /v1/messages | x-api-key: <cabin key> | Claude(只限官方客户端) |
| Gemini 原生 | /v1beta/models/<gemini id>:generateContent/v1beta/models/<gemini id>:streamGenerateContent | x-goog-api-key: <cabin key> | Gemini;流式请求加 ?alt=sse |
每次调用分四项计费:输入、输出、缓存写入、缓存读取,单价见价格页。Anthropic 的 count_tokens 与 Gemini 的 countTokens 不收费。
402 表示余额或月卡额度用完;403 表示月卡钥匙调了别的系列;429 表示超过限速:每把钥匙每分钟 120 次,每个账号同时 8 个请求。