Documentación

Empieza en 2 minutos.

La API de Geraikita AI admite dos formatos a la vez: OpenAI Chat Completions y Anthropic Messages. Usa el SDK de OpenAI, el SDK de Anthropic, Claude Code CLI, Cline y otras herramientas — solo cambia la URL base y la clave API.

URL base (OpenAI)https://ai.geraikita.com/v1

URL base (Anthropic)https://ai.geraikita.com

AutenticaciónBearer gk-... (o x-api-key: gk-...)

Importante — no escribas /v1 dos veces.

OpenAIhttps://ai.geraikita.com/v1Los clientes de OpenAI añaden /chat/completions a la URL base — así que la base termina en /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comLos clientes de Anthropic (Claude Code CLI, SDK de Anthropic) añaden /v1/messages por sí mismos — así que la base va sin /v1.

Si te equivocas, la ruta se convierte en /v1/v1/messages → error 400.

El nivel gratuito (Bansos) usa una CLAVE SEPARADA — no tu clave de pago.

La clave bansos debe reclamarse primero en la página de Bansos (inicio de sesión + verificación por Telegram, gratis, una vez por cuenta). Una clave gk- de pago del Panel no funciona en el endpoint bansos, y viceversa — mezclarlas devuelve 401 unauthorized.

La URL base de bansos también es diferente de la de pago de arriba:

URL base bansoshttps://ai.geraikita.com/v1/claude

OpenAIhttps://ai.geraikita.com/v1/claude/chat/completions

Anthropic / Claude Code CLIANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeEl SDK añade /v1/messages por sí mismo → https://ai.geraikita.com/v1/claude/v1/messages.

Descubrimiento de modelosGET https://ai.geraikita.com/v1/claude/models

Todo lo demás es exactamente igual que en el endpoint de pago.

Autenticación

Cada solicitud lleva tu clave API gk- en la cabecera Authorization: Bearer gk-.... Las claves se crean en el panel y se muestran solo una vez al crearlas — guárdalas en un lugar seguro. Puedes restringir cada clave a modelos concretos (lista blanca).

Primera solicitud

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.geraikita.com/v1",
    api_key="gk-xxxxxxxx",
)
resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

Claude Code CLI

Claude Code usa el formato Anthropic. Configura la URL base como la raíz (https://ai.geraikita.com — sin /v1) y luego ejecuta claude. Usa los modelos claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# URL base = RAÍZ sin /v1 (Claude Code añade /v1/messages por sí mismo)
export ANTHROPIC_BASE_URL="https://ai.geraikita.com"
export ANTHROPIC_AUTH_TOKEN="gk-xxxxxxxx"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

Cline y otras herramientas

Cline / Roo (OpenAI Compatible): proveedor OpenAI Compatible, URL base https://ai.geraikita.com/v1, clave API gk-..., ID de modelo claude-sonnet-5.

Cline (Anthropic): proveedor Anthropic, URL base https://ai.geraikita.com, clave API gk-....

¿Tu herramienta detecta modelos automáticamente? El endpoint GET https://ai.geraikita.com/v1/models está disponible. Si hay un campo "Gateway base URL" que añade automáticamente /v1/models, rellénalo con https://ai.geraikita.com (raíz) para que no se convierta en /v1/v1/models.

GeraiPoints

1 GP = Rp1. Se te factura por token según el uso real de cada solicitud — sin tarifa fija por solicitud, solo un pequeño mínimo por solicitud para cada modelo (suelo). Recarga GeraiPoints en el panel; tu saldo nunca caduca y sirve para cualquier modelo. Sin suscripciones ni cupos mensuales.

Lista de modelos

Los valores de model que puedes enviar. Consulta la página de precios para las tarifas de cada modelo.

Escribe el nombre del modelo EXACTAMENTE como aparece — sin prefijo. Envía claude-sonnet-5, no gp/claude-sonnet-5 ni openai/claude-sonnet-5. Algunos clientes/CLI anteponen al modelo el nombre de un proveedor (p. ej., un perfil llamado gp → el modelo queda como gp/claude-sonnet-5) → el resultado es 404 unknown model. El prefijo gk- es para claves API (la cabecera Authorization), no para nombres de modelos.

Crear una clave API

Abre el Panel → Crear clave API, dale un nombre y (opcionalmente) restríngela a modelos concretos. La clave en bruto se muestra solo una vez. Hasta 5 claves activas por cuenta — revoca una antigua para crear una nueva.

Códigos de error

Estado	Significado
400	URL base / body incorrectos — asegúrate de no duplicar /v1 (p. ej., /v1/v1/messages)
401	Clave API inválida / carril equivocado — clave de pago ≠ clave bansos. Revisa la URL base: la de pago usa /v1, bansos usa /v1/claude
402	GeraiPoints insuficientes — recarga, por favor
403	Modelo no permitido para esta clave
404	Modelo desconocido — envía el NOMBRE EXACTO DEL MODELO (p. ej., claude-sonnet-5), sin prefijo. Nombres como gp/claude-sonnet-5 u openai/... darán 404
429	Demasiadas solicitudes