GeraikitaGeraikita AI
MenúAutenticación

Autenticación

Cada solicitud se autentica con tu clave API, que empieza por gk-. El coste se descuenta del saldo de GeraiPoints de la cuenta propietaria de la clave.

Enviar la clave API

Envía la clave en una de estas cabeceras. Ambas funcionan en todos los endpoints de pago.

CabeceraFormatoDescripción
AuthorizationBearer gk-…Predeterminada en los clientes con formato OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Predeterminada en los clientes con formato Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01El SDK de Anthropic la envía automáticamente; inclúyela si llamas a /v1/messages directamente.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Si la clave no se envía, es incorrecta o ha sido revocada, el servidor responde 401 con type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Crear y revocar claves

  1. Abre el Panel y elige Crear API key.
  2. Ponle un nombre que describa su uso (p. ej. laptop-kantor o server-produksi) y, si hace falta, elige los modelos permitidos.
  3. Copia la clave y guárdala en un lugar seguro. Para revocarla, pulsa Revocar en la lista de claves: las solicitudes con esa clave se rechazan de inmediato.
La clave completa solo se muestra una vez al crearla y no se puede volver a ver. Máximo 20 claves activas por cuenta: revoca una antigua para crear una nueva.

Restringir una clave a modelos concretos

Cada clave puede restringirse a una lista de modelos concretos (allowlist). Una lista vacía significa que se permiten todos los modelos. Las solicitudes a modelos fuera de la lista reciben 403 permission_error, y GET /v1/models con esa clave solo muestra los modelos permitidos. Úsalo en las claves que compartes con apps o equipos para mantener el gasto bajo control.

Tipos de clave

ClaveUsoURL base
gk-API de pago — se descuenta de GeraiPoints. Se crea en el Panel.https://ai.geraikita.com/v1
gk- (bansos)Nivel gratuito — cupo diario, endpoint independiente. Consulta Nivel gratuito (Bansos). No funciona en los endpoints de pago, y viceversa.https://ai.geraikita.com/v1/claude
gkr-Programa de revendedores — se gestiona en la página Reseller.—

Mantener la clave segura

  • No pongas la clave en código front-end (navegador, apps móviles). Llama a la API desde tu propio servidor.
  • Guarda la clave en variables de entorno o en un gestor de secretos, y nunca la incluyas en un commit de un repositorio.
  • Usa una clave por app o dispositivo, para poder seguir el uso fácilmente y revocar una clave sin afectar a las demás.
  • ¿Sospechas que se ha filtrado una clave? Revócala de inmediato en el Panel y crea una nueva.