Códigos de error de la API
Códigos de error frecuentes al llamar a la API de Kimi 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 y que no haya caducado 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; comunícate con soporte si es necesario. |
| 404 | No encontrado | Revisa la ruta de la URL de la solicitud y el nombre del modelo. Confirma que el endpoint sea https://api.moonshot.ai/v1/.... |
| 429 | Too Many Requests | Se superó el rate limit. Reduce la frecuencia, implementa un retroceso exponencial o comunícate con soporte para obtener límites más altos. |
| 500 | Internal Server Error | Problema temporal del servidor: vuelve a intentarlo más tarde. Si persiste, comunícate con [email protected] e incluye el request_id. |
Consejos generales de resolución de problemas
- Revisa el mensaje de error completo: La respuesta en JSON incluye
error.messagecon una descripción detallada. - Anota el request_id: Ayuda a que soporte ubique el problema rápidamente.
- Consulta la documentación oficial: Asegúrate de que tus llamadas coincidan con la documentación en platform.kimi.ai.
- Implementa lógica de reintentos: Para los errores 429 y 500, usa un retroceso exponencial.