Documentação

Escolha a ferramenta que você já usa e altere as duas ou três linhas indicadas na seção dela. A API tem um endereço próprio, separado deste site:

https://api.apicabin.ai

Claude Code

Defina duas variáveis de ambiente antes de iniciar o claude (macOS / Linux):

export ANTHROPIC_BASE_URL="https://api.apicabin.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_CABIN_KEY"
claude

No Windows, a versão para PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.apicabin.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_CABIN_KEY"
claude

Os modelos Claude só aceitam o Claude Code oficial (2.1.285 ou mais recente) e o Claude Desktop. Chamadas ao Claude feitas por outros clientes são recusadas pelo provedor e não são cobradas.

Codex

Edite ~/.codex/config.toml e adicione um provedor que aponte para a cabana:

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

Coloque sua chave na variável de ambiente indicada ali e rode o Codex como de costume:

export APICABIN_KEY="YOUR_CABIN_KEY"
codex

O Codex usa modelos GPT. Experimente gpt-5.6-sol ou gpt-6-astra, ou gpt-6.1-sol quando quiser gastar menos.

Cursor

Abra as configurações do Cursor e vá até a página de modelos.
Cole sua chave da cabana no campo de chave de API da OpenAI.
Ative a opção de substituir a base url da OpenAI e digite https://api.apicabin.ai/v1.
Use a opção de adicionar modelo para incluir os IDs que quiser, como gpt-5.6-sol ou qwen3.7-plus, e depois clique em Verificar.

O Cursor só consegue acessar modelos que falam o protocolo compatível com OpenAI. Para usar Claude, vá de Claude Code.

Cherry Studio

Configurações → Provedor de modelos → Adicionar e escolha OpenAI como tipo de provedor.
Defina o host da API como https://api.apicabin.ai e use sua chave da cabana como chave de API.
Clique em Gerenciar e marque os modelos que quiser na lista carregada.
Para usar Gemini, adicione um segundo provedor do tipo Gemini com o mesmo host e a mesma chave.

Seu próprio código

Com o SDK oficial da OpenAI para Python, só muda o 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)

O Gemini usa seu próprio endpoint 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."}]}]}'

IDs de modelos Gemini que você pode usar: gemini-2.5-flash, gemini-3.1-pro, gemini-3.8-flash, gemini-4-argon

Referência de protocolos

Protocolo	Caminhos	Onde vai a chave	Modelos
Compatível com 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 (somente clientes oficiais)
Gemini (formato próprio)	`/v1beta/models/<gemini id>:generateContent` `/v1beta/models/<gemini id>:streamGenerateContent`	`x-goog-api-key: <cabin key>`	Gemini; adicione ?alt=sse para receber em streaming

Cada chamada é cobrada em quatro partes: entrada, saída, gravações em cache e leituras de cache, pelos valores da página de preços. Anthropic count_tokens e Gemini countTokens são gratuitos.

402 significa que o saldo ou a cota do plano acabou; 403 significa que uma chave de plano tentou acessar outra família de modelos; 429 significa que um limite foi atingido: 120 requisições por minuto por chave e 8 ao mesmo tempo por conta.