Autenticación - Geek Hub

Geek Hub usa API keys con prefijo ghub_sk_ que se envían en el header Authorization: Bearer.

Formato de las keys

Tipo	Prefijo	Uso
Producción	`ghub_sk_live_`	Llamadas reales, consumen saldo
Sandbox (próximo)	`ghub_sk_test_`	Pruebas sin saldo

Cada key tiene 45 caracteres en total. El prefijo ghub_sk_live_ (13 chars) + 32 chars aleatorios.

Si pierdes la key, no podemos recuperarla. Tienes que revocar la actual y generar una nueva.

Pásala en el header Authorization:

curl https://api.geekhub.mx/v1/models \
  -H "Authorization: Bearer ghub_sk_live_xxxxx"

O con los SDKs:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.geekhub.mx/v1",
    api_key="ghub_sk_live_xxxxx",  # idealmente desde env var
)

No hardcodees keys en código

Usa variables de entorno (process.env.GEEKHUB_API_KEY) o servicios de secrets (AWS Secrets Manager, Vault, etc).

Una key por entorno / app

Crea keys separadas para producción, staging, CI, etc. Si una se compromete, revocas solo esa.

Revoca keys sin uso

En el dashboard, las keys sin tráfico aparecen marcadas. Revócalas para reducir superficie de ataque.

Rota periódicamente

Cada 90 días: genera nueva, despliega, revoca la vieja.

Código HTTP	Mensaje	Causa
`401`	`missing_api_key`	No mandaste header `Authorization`
`401`	`invalid_api_key`	Key no existe o está revocada
`402`	`insufficient_balance`	Tu saldo es ≤ $0 MXN, recarga

Ver Errores para el catálogo completo.