Use este guia para diagnosticar e resolver problemas comuns que surgem em você chamar a API Gemini. Se você tiver problemas com a chave de API, verifique se configurou sua chave de API corretamente, de acordo com o guia de configuração da chave de API.
Códigos de erro
A tabela a seguir lista códigos de erros comuns que você pode encontrar, junto com explicações para suas causas e etapas de solução de problemas:
| Código HTTP | Status | Descrição | Solução |
| 400 | INVALID_ARGUMENT | O corpo da solicitação está incorreto. | Confira a referência da API para ver o formato da solicitação, exemplos e versões compatíveis. O uso de recursos de uma versão mais recente da API com um endpoint mais antigo pode causar erros. |
| 400 | FAILED_PRECONDITION | O nível sem custo financeiro da API Gemini não está disponível no seu país. Ative o faturamento do seu projeto no Google AI Studio. | Para usar a API Gemini, você precisa configurar um plano pago usando o Google AI Studio. |
| 403 | PERMISSION_DENIED | Sua chave de API não tem as permissões necessárias. | Verifique se sua chave de API está definida e tem o acesso correto. |
| 404 | NOT_FOUND | O recurso solicitado não foi encontrado. | Verifique se todos os parâmetros da solicitação são válidos para a versão da API. |
| 429 | RESOURCE_EXHAUSTED | Você ultrapassou o limite de taxa. | Verifique se você está dentro do limite de taxa do modelo. Solicite um aumento de cota, se necessário. |
| 500 | INTERNAL | Ocorreu um erro inesperado no Google. | Aguarde um pouco e tente fazer a solicitação novamente. Se o problema persistir após uma nova tentativa, use o botão Enviar feedback no Google AI Studio para relatar o problema. |
| 503 | INDISPONÍVEL | O serviço pode estar temporariamente sobrecarregado ou indisponível. | Aguarde um pouco e tente fazer a solicitação novamente. Se o problema persistir após uma nova tentativa, use o botão Enviar feedback no Google AI Studio para relatar o problema. |
Verifique se há erros de parâmetro de modelo nas chamadas de API
Verifique se os parâmetros do modelo estão dentro dos seguintes valores:
| Parâmetro do modelo | Valores (intervalo) |
| Contagem de candidatos | 1 a 8 (inteiro) |
| Temperatura | 0,0-1,0 |
| Máximo de tokens de saída |
Usar
get_model (Python)
para determinar o número máximo de tokens do modelo que você está usando.
|
| TopP | 0,0-1,0 |
Além de verificar os valores dos parâmetros, certifique-se de estar usando o
Versão da API (por exemplo, /v1 ou /v1beta) e
de computação que oferece suporte
para os recursos de que você precisa. Por exemplo, se um recurso estiver na versão Beta
será disponibilizado apenas na versão /v1beta da API.
Verifique se você tem o modelo certo
Use um modelo com suporte listado em nossa página de modelos.
Problemas de segurança
Caso você veja que uma solicitação foi bloqueada devido a uma configuração de segurança na sua chamada de API, revise o comando em relação aos filtros definidos na chamada de API.
Caso você veja BlockedReason.OTHER, é possível que a consulta ou resposta viole os termos
de serviço ou não são suportados de outra forma.
Melhorar a saída do modelo
Para resultados de modelo de maior qualidade, aprenda a escrever comandos mais estruturados. O a página de introdução à criação de comandos apresenta alguns conceitos básicos, estratégias e práticas recomendadas para você começar.
Se você tiver centenas de exemplos de bons pares de entrada/saída, também poderá considere o ajuste de modelos.
Entender os limites de tokens
Leia nosso guia de tokens para entender melhor como para contar tokens e seus limites.
Problemas conhecidos
- A API aceita apenas o inglês. Enviar comandos em idiomas diferentes pode produza respostas inesperadas ou até mesmo bloqueadas. Confira os recursos disponíveis idiomas para atualizações.
Informar um bug
Participe da discussão no fórum para desenvolvedores de IA do Google se tiver dúvidas.