Documentación
Elige la herramienta que ya usas y cambia las dos o tres líneas que indica su sección. La API tiene una dirección propia, distinta de la de este sitio:
https://api.apicabin.ai
Claude Code
Configura dos variables de entorno antes de ejecutar claude (macOS / Linux):
export ANTHROPIC_BASE_URL="https://api.apicabin.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_CABIN_KEY"
claude
En Windows, la versión para PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.apicabin.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_CABIN_KEY"
claude
Los modelos de Claude solo aceptan el cliente oficial de Claude Code (2.1.285 o posterior) y Claude Desktop. El proveedor rechaza las llamadas a Claude desde otros clientes, y esas solicitudes no se cobran.
Codex
Edita ~/.codex/config.toml y agrega un proveedor que apunte a la cabaña:
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
Pon tu clave en la variable de entorno que se indica ahí y ejecuta Codex como siempre:
export APICABIN_KEY="YOUR_CABIN_KEY"
codex
Codex funciona con modelos GPT. Prueba gpt-5.6-sol o gpt-6-astra, o gpt-6.1-sol si quieres gastar menos.
Cursor
- Abre la configuración de Cursor y ve a la página de modelos.
- Pega tu clave de la cabaña en el campo de clave de API de OpenAI.
- Activa la opción para reemplazar la base url de OpenAI e ingresa https://api.apicabin.ai/v1.
- Usa Agregar modelo para añadir los identificadores que quieras, como gpt-5.6-sol o qwen3.7-plus, y luego pulsa Verificar.
Cursor solo puede conectarse a modelos que hablan el protocolo compatible con OpenAI. Para Claude, usa Claude Code.
Cherry Studio
- Configuración → Proveedor de modelos → Agregar, y elige OpenAI como tipo de proveedor.
- Configura el host de la API como https://api.apicabin.ai y usa tu clave de la cabaña como clave de API.
- Pulsa Administrar y marca los modelos que quieras en la lista que se cargue.
- Para Gemini, agrega un segundo proveedor de tipo Gemini con el mismo host y la misma clave.
Tu propio código
Con el SDK oficial de Python de OpenAI, solo cambia 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 usa su propio 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."}]}]}'
Identificadores de modelos Gemini que puedes usar: gemini-2.5-flash, gemini-3.1-pro, gemini-3.8-flash, gemini-4-argon
Referencia de protocolos
| Protocolo | Rutas | Cabecera de la clave | Modelos |
|---|---|---|---|
| Compatible con 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 (solo clientes oficiales) |
| Gemini (formato propio) | /v1beta/models/<gemini id>:generateContent/v1beta/models/<gemini id>:streamGenerateContent | x-goog-api-key: <cabin key> | Gemini; agrega ?alt=sse para recibir la respuesta en streaming |
Cada llamada se cobra en cuatro partes: entrada, salida, escrituras en caché y lecturas de caché, según los precios de la página de tarifas. count_tokens de Anthropic y countTokens de Gemini son gratuitos.
402 significa que se agotó el saldo o la cuota del plan; 403, que se intentó usar una clave de plan con otra familia de modelos; 429, que se alcanzó un límite: 120 solicitudes por minuto por clave y 8 simultáneas por cuenta.