En esta página
Errores comunes
Errores que puede encontrar cualquier herramienta de agentes al conectar con HiAPI y cómo solucionarlos.
La guía de cada herramienta solo recoge los errores propios de esa herramienta. Estos pueden ocurrir con cualquiera. Fíjate primero en el código de estado o en la palabra clave del error y búscalo en la tabla siguiente:
| Error | Causa | Solución |
|---|---|---|
| 401 / invalid api key | La clave está incompleta, tiene espacios delante o detrás, o copiaste el valor enmascarado | Ve a API Keys, haz clic en el icono de copiar y vuelve a copiar la HiAPI API key completa |
| El error menciona saldo, cuota o un límite de gasto | El saldo de la cuenta es demasiado bajo, o el límite de gasto de esta clave está agotado | Recarga en Saldo de la cuenta o sube el límite de gasto de esta clave en la página API Keys |
| 403 | Esta clave no tiene permiso para el modelo | Revisa el grupo y los permisos de la clave; consulta Autenticación |
| 404 / model not available | La Base URL tiene un /v1 de más o le falta, o el nombre del modelo está mal escrito | Comprueba la URL con Base URL y protocolos; copia el nombre del modelo de la lista de modelos de texto |
| 400 does not support this endpoint | El protocolo seleccionado en la herramienta no lo admite este modelo | Prueba otro protocolo (por ejemplo, Anthropic Messages para Claude) o cambia a otro modelo |
| 400 stream must be true / carga infinita | El modelo solo funciona en streaming y la herramienta envió una solicitud sin streaming | Activa el streaming en la herramienta. Si el botón “Check” o “Test connection” de la herramienta devuelve este error, ignóralo y fíate de un chat real |
| 429 | Demasiadas solicitudes o demasiada concurrencia | Espera y reintenta, y ejecuta menos tareas a la vez; si el error menciona una cuota, sigue la fila “saldo, cuota” de arriba |
| 500 / 502 / 503 | El servicio del modelo falló temporalmente | Espera un minuto o dos y reintenta; si sigue pasando, prueba primero otro modelo y luego contáctanos |
| Tiempo de espera agotado / respuesta interrumpida | La red o un proxy bloquearon la conexión de larga duración | Revisa las reglas de red y de proxy para api.hiapi.ai y vuelve a intentarlo |
Consulta el registro de solicitudes antes de reintentar
Puede que una tarea de agentes ya haya terminado en el servidor y solo se haya caído la conexión de la herramienta. Antes de reintentar, consulta Registro de solicitudes para ver si esta solicitud se completó y cuánto costó, y no pagar dos veces por el mismo trabajo.
Si sigues atascado
Abre un ticket en Contacto con la información siguiente; nos ayuda a localizar el problema más rápido:
- La hora del error (al minuto)
- La herramienta y la versión que usaste, por ejemplo Claude Code 2.1.284
- El nombre del modelo y la Base URL
- El texto original del error o una captura de pantalla
Tapa la API key antes de hacer la captura y no envíes nunca la clave a nadie, tampoco al soporte.