Use este guia para diagnosticar e resolver problemas comuns que surgem quando você chama a API Gemini. Se você encontrar problemas de chave de API, verifique se ela foi configurada corretamente, de acordo com o guia de configuração de chaves de API.
Códigos de erro
A tabela a seguir lista os códigos de erro comuns que você pode encontrar, além de explicações sobre as 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. | Consulte a referência da API para ver formatos de 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. |
| 403 | PERMISSION_DENIED | Sua chave de API não tem as permissões necessárias. | Verifique se a chave de API está configurada e tem o acesso correto. |
| 404 | NOT_FOUND | O recurso solicitado não foi encontrado. | Verifique se todos os parâmetros na 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 enviar sua solicitação novamente. Se o problema persistir após uma nova tentativa, informe-o usando o botão Enviar feedback no Google AI Studio. |
| 503 | UNAVAILABLE | O serviço pode estar temporariamente sobrecarregado ou fora do ar. | Aguarde um pouco e tente enviar sua solicitação novamente. Se o problema persistir após uma nova tentativa, informe-o usando o botão Enviar feedback no Google AI Studio. |
Verifique se há erros de parâmetro do modelo nas suas 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 | De 1 a 8 (número inteiro) |
| Temperatura | 0,0-1,0 |
| Máximo de tokens de saída |
Use
get_model (Python)
para determinar o número máximo de tokens para o modelo que você está usando.
|
| TopP | 0,0-1,0 |
Além de verificar os valores de parâmetro, confira se você está usando a versão correta da API, por exemplo, /v1 ou /v1beta) e um modelo compatível com os recursos necessários. Por exemplo, se um recurso estiver na versão
Beta, ele só vai estar disponível na versão /v1beta da API.
Verifique se você tem o modelo certo
Verifique se você está usando um modelo com suporte. Use list_models
(Python) para acessar todos os modelos
disponíveis.
Problemas de segurança
Se você notar que uma solicitação foi bloqueada devido a uma configuração de segurança na chamada de API, analise a solicitação em relação aos filtros definidos na chamada de API.
Se você encontrar BlockedReason.OTHER, a consulta ou a resposta pode violar os Termos de Serviço ou não ter suporte.
Melhorar a saída do modelo
Para resultados de modelo de maior qualidade, tente escrever comandos mais estruturados. A página Introdução ao design 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á considerar o ajuste de modelos.
Entender os limites de tokens
Use a API ModelService para receber outros
metadados sobre os modelos, incluindo limites de
tokens de entrada e saída.
Para receber os tokens usados pelo comando, use
countMessageTokens
para modelos de chat e
countTextTokens para
modelos de texto.
Problemas conhecidos
- Suporte para dispositivos móveis do Google AI Studio: embora seja possível abrir o site em um dispositivo móvel, ele não foi otimizado para telas pequenas.
- A API só oferece suporte ao inglês. O envio de prompts em idiomas diferentes pode produzir respostas inesperadas ou até mesmo bloqueadas. Consulte os idiomas disponíveis para atualizações.
Informar um bug
Registre um problema no GitHub para fazer perguntas ou enviar solicitações de recursos ou bugs.