ApiCabin

文档

先挑你手上的工具,照那一节改两三行配置。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

  1. 打开 Cursor Settings,进入 Models 页面。
  2. 在 OpenAI API Key 一栏粘贴你的小屋钥匙。
  3. 打开 Override OpenAI Base URL,填入 https://api.apicabin.ai/v1。
  4. 点 Add model 加上要用的调用名,比如 gpt-5.6-sol 或 qwen3.7-plus,再点 Verify。

Cursor 里只能用 OpenAI 兼容协议的模型;要用 Claude,请换 Claude Code。

Cherry Studio

  1. 设置 → 模型服务 → 添加,提供商类型选 OpenAI。
  2. API 地址填 https://api.apicabin.ai,API 密钥填你的小屋钥匙。
  3. 点「管理」,从拉回来的列表里勾选要用的模型。
  4. 要用 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/messagesx-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 个请求。