GeraikitaGeraikita AI
MenúInicio rápido

Inicio rápido

De cero a la primera respuesta en tres pasos: prepara la URL base, crea una clave API y envía la solicitud.

URL base

Los clientes con formato OpenAI usan una URL base que termina en /v1. Los clientes con formato Anthropic usan la raíz sin /v1, porque su SDK añade /v1/messages por sí mismo.

AjusteValorUsado por
base_urlhttps://ai.geraikita.com/v1SDK de OpenAI, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue
base_urlhttps://ai.geraikita.comSDK de Anthropic, Claude Code CLI, Cline (Anthropic)
api_keygk-…Todos los clientes — la clave se crea en el Panel

Crear una clave API

  1. Inicia sesión en Geraikita AI.
  2. Recarga GeraiPoints en la página Recargar (u obtén una clave gratuita en Bansos).
  3. Abre el Panel → Crear API key. Copia la clave gk-…: la clave completa solo se muestra una vez.
Guarda la clave en una variable de entorno, p. ej. export GERAIKITA_API_KEY=gk-…, en lugar de escribirla directamente en el código.

Primera solicitud

Elige el lenguaje o el SDK que usas. Todos los ejemplos llaman al modelo claude-sonnet-5; cámbialo por otro id de la lista de modelos.

curl https://ai.geraikita.com/v1/chat/completions \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

La respuesta tiene el mismo formato JSON que la API de OpenAI (o la de Anthropic, si usas /v1/messages), incluido el objeto usage con el número de tokens facturados.

Respuesta en stream

Para respuestas largas y herramientas agénticas, activa stream para que los fragmentos de la respuesta lleguen al momento. El servidor envía las cabeceras de inmediato y señales keepalive mientras espera el primer token. Configura el timeout de tu app en al menos 300 segundos.

curl https://ai.geraikita.com/v1/chat/completions -N \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

Próximos pasos