Autenticación

Autenticación

Todas las peticiones a la API de HydraSkill requieren autenticación mediante API key.

Formato de la API key

Las claves siguen el formato: sk- seguido de 64 caracteres hexadecimales.

sk-a1b2c3d4e5f6...

Métodos de autenticación

Cabecera (recomendado)

curl https://api.hydraskill.ai/v1/proxy \
  -H "Authorization: Bearer sk-your-key-here"

SDK (autoconfigurado)

from hydraskill import ProxyClient

# Opción 1: pasarla directamente
client = ProxyClient(api_key="sk-your-key-here")

# Opción 2: variable de entorno (recomendado)
# export HYDRASKILL_API_KEY="sk-your-key-here"
client = ProxyClient()

Gestión de claves

• Crea claves en Dashboard → API Keys
• Cada clave tiene límites de QPS configurables
• Las claves se pueden habilitar/deshabilitar sin eliminarlas
• Rota las claves con regularidad por seguridad

Límites de tasa

Plan	QPS por clave	Máx. claves
Starter	10	5
Pro	50	10
Enterprise	Personalizado	Ilimitadas

Respuestas de error

// Clave inválida o ausente
{ "error": "unauthorized", "message": "Invalid API key" }

// Clave deshabilitada
{ "error": "forbidden", "message": "API key is disabled" }

// Límite de tasa alcanzado
{ "error": "rate_limited", "message": "QPS limit exceeded", "retry_after_ms": 1000 }