Saltar a contenido

Configuración de BYOAPI

Guía paso a paso para configurar tu API key en Lumilink.

Paso 1: Obtener API Key

  1. Ve a console.anthropic.com
  2. Crea una cuenta o inicia sesión
  3. Ve a API Keys → Create Key
  4. Dale un nombre (ej: "Lumilink Production")
  5. Copia la key (empieza con sk-ant-api...)

Guarda tu key

Solo se muestra una vez. Guárdala en un lugar seguro.

  1. Ve a platform.openai.com
  2. Crea una cuenta o inicia sesión
  3. Ve a API Keys → Create new secret key
  4. Dale un nombre
  5. Copia la key (empieza con sk-...)
  1. Ve a makersuite.google.com
  2. Crea una cuenta o inicia sesión
  3. Ve a Get API Key
  4. Copia la key

Via Dashboard

  1. Abre chat.lumilink.io
  2. Ve a Settings → External Models
  3. Click en Add Key
  4. Selecciona el provider (Anthropic, OpenAI, etc.)
  5. Pega tu API key
  6. Configura límites (opcional)
  7. Click Save

Via API

curl -X POST https://api.lumilink.io/v1/byoapi/keys \
  -H "Authorization: Bearer YOUR_LUMILINK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "anthropic",
    "key_name": "Production Key",
    "api_key": "sk-ant-api...",
    "visibility_filter": "internal",
    "usage_limits": {
      "max_tokens_per_day": 100000,
      "max_tokens_per_month": 1000000
    }
  }'

Paso 3: Configurar Límites

Parámetro Descripción Default
max_tokens_per_day Máximo de tokens diarios 100,000
max_tokens_per_month Máximo de tokens mensuales 1,000,000
max_requests_per_minute Rate limit de requests 60

Recomendación

Comienza con límites conservadores y aumenta según tu uso.

Paso 4: Seleccionar Modelos

Por defecto, tu key puede acceder a todos los modelos del provider. Puedes restringirlo:

{
  "allowed_models": [
    "claude-3-haiku-20240307",
    "claude-3-5-sonnet-20241022"
  ]
}

Modelos disponibles por provider

Modelo ID Costo/1M tokens
Claude 3.5 Sonnet claude-3-5-sonnet-20241022 \(3/\)15
Claude 3.5 Haiku claude-3-5-haiku-20241022 \(0.25/\)1.25
Claude 3 Opus claude-3-opus-20240229 \(15/\)75
Modelo ID Costo/1M tokens
GPT-4o gpt-4o \(2.50/\)10
GPT-4o mini gpt-4o-mini \(0.15/\)0.60
GPT-4 Turbo gpt-4-turbo \(10/\)30

Paso 5: Usar en Chat

Una vez configurada tu key:

  1. Abre cualquier chat en Lumilink
  2. En el selector de modelo, verás opciones con "(BYOK)"
  3. Selecciona claude-3-haiku (BYOK) por ejemplo
  4. ¡Chatea normalmente!
┌─────────────────────────────────────────┐
│ Seleccionar modelo                      │
├─────────────────────────────────────────┤
│ ○ aurora-companion (local)              │
│ ○ claude-3-haiku (Lumilink)             │
│ ● claude-3-haiku (BYOK) ← Tu key        │
│ ○ gpt-4o-mini (BYOK)                    │
└─────────────────────────────────────────┘

Verificar Configuración

Test de conectividad

curl https://api.lumilink.io/v1/byoapi/keys/YOUR_KEY_ID/test \
  -H "Authorization: Bearer YOUR_TOKEN"

Response exitoso: 

{
  "status": "valid",
  "provider": "anthropic",
  "visibility_filter": "internal",
  "usage": {
    "tokens_today": 1523,
    "tokens_month": 45678
  }
}

Dashboard de uso

Ve a Settings → External Models → Usage para ver:

  • Tokens usados por día/mes
  • Costo estimado
  • Requests por modelo
  • Governance aplicada

Troubleshooting

Error: Invalid API Key

  • Verifica que copiaste la key completa
  • Asegúrate de que la key no expiró
  • Verifica que tienes créditos en el provider

Error: Rate Limit Exceeded

  • Aumenta tus límites en Settings
  • O espera al reset diario/mensual

Error: Model Not Allowed

  • Verifica allowed_models en tu configuración
  • Agrega el modelo que quieres usar

Próximos pasos