Preguntas frecuentes
Este capítulo recopila los códigos de error y escenarios de excepción más comunes al usar Antigravity Tools, ayudándote a localizar rápidamente la causa raíz del problema y encontrar soluciones.
Contenido de este capítulo
| Tipo de problema | Página | Descripción |
|---|---|---|
| Cuenta desactivada | invalid_grant y desactivación automática de cuentas | ¿La cuenta de repente no está disponible? Entiende las causas de la invalidación del token OAuth y el proceso de recuperación |
| Falla de autenticación | 401/falla de autenticación | ¿Solicitud rechazada? Verifica la configuración de auth_mode y el formato de Header |
| Error de limitación | 429/error de capacidad | ¿429 frecuente? Distingue entre cuota insuficiente y limitación upstream, usa estrategias de rotación para reducir el impacto |
| Error de ruta | 404/ruta incompatible | ¿API 404? Resuelve el problema de concatenación de Base URL y prefijo /v1 |
| Excepción de streaming | interrupción de streaming/0 Token/firma inválida | ¿Respuesta interrumpida o vacía? Entiende el mecanismo de autorecuperación del proxy y la ruta de investigación |
Ruta de aprendizaje recomendada
Investigación por código de error: Cuando encuentres un error específico, ve directamente a la página correspondiente.
Aprendizaje sistemático: Si deseas comprender completamente los posibles problemas, se recomienda leer en el siguiente orden:
- 404/ruta incompatible — El problema más común de integración, generalmente el primer obstáculo
- 401/falla de autenticación — La ruta es correcta pero la solicitud es rechazada, verifica la configuración de autenticación
- invalid_grant y desactivación automática de cuentas — Problemas a nivel de cuenta
- 429/error de capacidad — La solicitud tiene éxito pero está limitada
- interrupción de streaming/0 Token/firma inválida — Problemas avanzados, involucran respuestas de streaming y mecanismos de firma
Requisitos previos
Recomendación
- Iniciar proxy local e integrar el primer cliente — Asegúrate de que el entorno básico funcione
- Agregar cuentas — Conoce la forma correcta de agregar cuentas
Siguientes pasos
Después de resolver los problemas, puedes continuar con un aprendizaje profundo:
- Programación de alta disponibilidad — Usa estrategias de rotación y reintento para reducir la ocurrencia de errores
- Proxy Monitor — Usa el sistema de registros para rastrear detalles de solicitudes
- Guía completa de configuración — Conoce el propósito de todos los elementos de configuración