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.

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

OpenCode

OpenCode lee sus proveedores de un archivo de configuración. Registra Geraikita como proveedor compatible con OpenAI en ~/.config/opencode/opencode.json, o en un opencode.json del proyecto.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "geraikita": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Geraikita AI",
      "options": {
        "baseURL": "https://ai.geraikita.com/v1",
        "apiKey": "{env:GERAIKITA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.6-sol": { "name": "GPT 5.6 Sol" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }
      }
    }
  }
}

Luego exporta tu clave y abre OpenCode. Elige el modelo con /models: aparece como geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Importante: las claves bajo models se envían tal cual a la API, así que deben coincidir exactamente con los ids públicos de los modelos de Geraikita.

Recuerda: escribe el nombre del modelo exactamente como aparece en la página de precios, sin prefijo.

9router

9router es un proxy local que reparte las peticiones entre varios proveedores y escucha en http://localhost:20128. No apuntas tus herramientas a Geraikita directamente: registras Geraikita como uno de los proveedores upstream de 9router.

1. Abre el panel de 9router en http://localhost:20128/dashboard.
2. Ve a Providers y añade un endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, clave API gk-xxxxxxxx.
3. Tus herramientas siguen apuntando a 9router (http://localhost:20128/v1) y solo eliges un modelo de Geraikita: 9router reenvía esas peticiones a Geraikita.

# tu herramienta sigue apuntando a 9router, no a Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Así mantienes el enrutamiento y el fallback entre proveedores de 9router mientras los tokens se pagan con tus GeraiPoints de Geraikita.

Recuerda: escribe el nombre del modelo exactamente como aparece en la página de precios, sin prefijo.

Hermes

Hermes (el Hermes Agent de NousResearch) funciona con cualquier endpoint compatible con OpenAI. Apúntalo a Geraikita en ~/.hermes/config.yaml.

model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # o ponla en ~/.hermes/.env

O ejecuta hermes model, elige Custom OpenAI-compatible endpoint e introduce la base URL y la clave: Hermes detecta por sí mismo los modelos disponibles con GET https://ai.geraikita.com/v1/models.

Recuerda: escribe el nombre del modelo exactamente como aparece en la página de precios, sin prefijo.

GeraiPoints

Lista de modelos

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

Crear una clave API

Códigos de error