Errores/Troubleshooting

Troubleshooting

Soluciones a los problemas mas comunes al usar la API de AstrApp.

Errores de autenticacion

"Unauthorized - Invalid API Key"

La API Key es incorrecta o fue revocada.

Soluciones:

Verifica que incluyes Bearer antes de la key
Genera una nueva key desde el dashboard
Revisa que no hay espacios extra en la key

bash

# Correcto
curl -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" ...

# Incorrecto (falta Bearer)
curl -H "Authorization: sk_live_xxxxxxxxxxxxx" ...

"Forbidden - Insufficient Permissions"

Tu API Key no tiene los permisos necesarios.

Solucion:

Genera una nueva key con los scopes requeridos. Por ejemplo, para entrenar necesitas models:write.

Rate limiting

"429 - Too Many Requests"

Excediste el limite de requests.

Solucion: Implementa backoff exponencial

javascript

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After') || 60;
      const delay = Math.pow(2, i) * 1000; // 1s, 2s, 4s
      await new Promise(r => setTimeout(r, delay));
      continue;
    }

    return response;
  }
  throw new Error('Max retries exceeded');
}

Errores de entrenamiento

"Dataset Validation Failed"

El dataset tiene errores de formato.

Causas comunes:

JSON mal formado en alguna linea
Campos requeridos faltantes
Caracteres especiales sin escapar

bash

# Validar JSONL localmente
cat training_data.jsonl | while read line; do
  echo "$line" | python -m json.tool > /dev/null || echo "Error: $line"
done

"Training Failed - Out of Memory"

El entrenamiento se quedo sin memoria.

Soluciones:

Reduce batch_size (ej: de 32 a 16)
Reduce max_tokens en los datos
Divide el dataset en partes mas pequenas

Errores de inferencia

"Model Not Ready"

Intentas usar un modelo que aun no termino de entrenar.

Solucion:

Espera a que el status del modelo sea "ready". Puedes verificarlo con GET /models/:id.

Tips generales

Revisa el request_id: Incluido en cada error para soporte
Usa el ambiente de staging: Para pruebas sin afectar produccion
Revisa status.astrapp.lat: Antes de asumir que es tu codigo
Implementa logs: Guarda requests y responses para debugging

Necesitas mas ayuda?

Contacta a soporte en support@astrapp.lat con el request_id del error.

Codigos de Error