Códigos de error de API
Códigos de error comunes al llamar a Kimi API y cómo resolverlos.
Referencia de códigos de error
| Código de error | Significado | Solución |
|---|---|---|
| 400 | Solicitud incorrecta | Revisa el formato del cuerpo de la solicitud, así como los nombres y tipos de los parámetros. Causas comunes: JSON mal formado, parámetros obligatorios faltantes o valores fuera de rango. |
| 401 | No autorizado | Verifica que la API Key sea correcta, que no haya vencido ni esté deshabilitada. Confirma el formato del encabezado: Authorization: Bearer <your-api-key>. |
| 403 | Prohibido (saldo insuficiente) | El saldo de la cuenta se agotó; recárgalo en la consola. La cuenta también podría estar restringida; si es necesario, contacta a soporte. |
| 404 | No encontrado | Revisa la ruta de la URL de la solicitud y el nombre del modelo. Confirma que el endpoint sea https://klmi.io/v1/.... |
| 429 | Too Many Requests | Se superó el rate limit. Reduce la frecuencia, implementa retroceso exponencial o contacta a soporte para solicitar límites más altos. |
| 500 | Internal Server Error | Problema temporal del servidor; vuelve a intentarlo más tarde. Si persiste, contacta a [email protected] con el request_id. |
Consejos generales para solucionar problemas
- Revisa el mensaje de error completo: La respuesta JSON incluye
error.messagecon una descripción detallada. - Anota el request_id: Ayuda a soporte a ubicar rápidamente el problema.
- Consulta la documentación oficial: Asegúrate de que las llamadas coincidan con la documentación en platform.kimi.ai.
- Implementa lógica de reintentos: Para errores 429 y 500, usa retroceso exponencial.