Usa esta guía para diagnosticar y resolver los problemas habituales que surgen cuando cuando llames a la API de Gemini. Si encuentras problemas con la clave de API, asegúrate de haber configurado tu clave de API de forma correcta según la guía de configuración de claves de API.
Códigos de error
En la siguiente tabla, se enumeran los códigos de error comunes que puedes encontrar, junto con explicaciones de sus causas y pasos para solucionar problemas:
| Código HTTP | Estado | Descripción | Solución |
| 400 | INVALID_ARGUMENT | El cuerpo de la solicitud es incorrecto. | Consulta la referencia de la API para ver el formato de solicitud, los ejemplos y las versiones compatibles. Usar funciones de una versión de API más reciente con un extremo más antiguo puede causar errores. |
| 400 | FAILED_PRECONDITION | El nivel gratuito de la API de Gemini no está disponible en tu país. Habilita la facturación en tu proyecto en Google AI Studio. | Para usar la API de Gemini, deberás configurar un plan pagado con Google AI Studio. |
| 403 | PERMISSION_DENIED | Tu clave de API no tiene los permisos necesarios. | Verifica que tu clave de API esté configurada y tenga el acceso correcto. |
| 404 | NOT_FOUND | No se encontró el recurso solicitado. | Verifica si todos los parámetros de tu solicitud son válidos para la versión de tu API. |
| 429 | RESOURCE_EXHAUSTED | Superaste el límite del porcentaje. | Asegúrate de estar dentro del límite de frecuencia del modelo. Solicita un aumento de la cuota si es necesario. |
| 500 | INTERNAL | Se produjo un error inesperado en Google. | Espera un momento y vuelve a enviar la solicitud. Si el problema persiste después de volver a intentarlo, infórmalo con el botón Enviar comentarios de Google AI Studio. |
| 503 | NO DISPONIBLE | El servicio puede estar temporalmente sobrecargado o inactivo. | Espera un momento y vuelve a enviar la solicitud. Si el problema persiste después de volver a intentarlo, infórmalo con el botón Enviar comentarios de Google AI Studio. |
Revisa tus llamadas a la API en busca de errores de parámetros del modelo
Asegúrate de que los parámetros de tu modelo estén dentro de los siguientes valores:
| Parámetro del modelo | Valores (rango) |
| Recuento de candidatos | 1-8 (número entero) |
| Temperatura | 0.0 a 1.0 |
| Cantidad máxima de tokens de salida |
Usa
get_model (Python)
para determinar la cantidad máxima de tokens
para el modelo que estás usando.
|
| TopP | 0.0 a 1.0 |
Además de verificar los valores de los parámetros, asegúrate de usar el
Versión de la API (p.ej., /v1 o /v1beta) y
que admita las funciones que necesitas. Por ejemplo, si una función está en versión beta
solo estará disponible en la versión de la API /v1beta.
Comprueba si tienes el modelo correcto
Asegúrate de usar un modelo compatible que se encuentra en nuestra página de modelos.
Problemas de seguridad
Si ves que un mensaje se bloqueó debido a una configuración de seguridad en tu llamada a la API, revisa la instrucción con respecto a los filtros que estableciste en la llamada a la API.
Si ves BlockedReason.OTHER, es posible que la consulta o la respuesta infrinjan los términos.
de servicio o no serán compatibles de otro modo.
Mejora la salida del modelo
Para obtener resultados de modelos de mayor calidad, explora la posibilidad de escribir instrucciones más estructuradas. El En la página de introducción al diseño de instrucciones, se presenta algunos conceptos básicos, estrategias y prácticas recomendadas para empezar.
Si tienes cientos de ejemplos de buenos pares de entrada/salida, también puedes considera el ajuste de modelos.
Información sobre los límites de tokens
Para comprender mejor cómo hacerlo, lee nuestra guía sobre tokens. para contar tokens y sus límites.
Problemas conocidos
- La API solo admite inglés. Enviar instrucciones en diferentes idiomas puede producen respuestas inesperadas o incluso bloqueadas. Ver disponibles idiomas para recibir actualizaciones.
Informa un error
Únete al debate en el foro para desarrolladores de IA de Google. si tienes preguntas.