Google Gemini API Tester
Build, run and copy Google Gemini generateContent API requests as cURL, Python and JavaScript.
A montagem da requisição e do código cURL, Python e JavaScript acontece inteiramente no seu navegador. Quando você pressiona Rodar, sua chave de API do Gemini e seu prompt são enviados diretamente do seu navegador para o Google (generativelanguage.googleapis.com), não para a ArrayKit. A chave fica apenas na memória do navegador deste dispositivo e nunca é armazenada ou enviada à ArrayKit. Como o Gemini coloca a chave na query string da URL, ela aparece nos trechos copiados - evite usar chaves de produção em máquinas compartilhadas e nunca cole a chave em algum lugar público.
Experimente o Testador da API OpenAI
Sobre Google Gemini API Tester
O Testador da API Gemini permite montar, rodar e copiar requisições generateContent do Google Gemini sem sair do navegador. Cole sua chave de API do Gemini, escolha um modelo como gemini-1.5-flash, gemini-1.5-pro ou gemini-2.0-flash, digite um prompt, e a ferramenta monta o POST para generativelanguage.googleapis.com com o corpo JSON correto de contents/parts e a chave na query string. Pressione Rodar para enviar a chamada e inspecionar a resposta bruta, ou copie trechos prontos para uso em cURL, Python e JavaScript para colocar no seu próprio código. Foi feito para desenvolvedores, engenheiros de prompt e qualquer pessoa avaliando o Gemini que queira uma forma rápida e sem complicação de confirmar que uma chave funciona, comparar modelos e pegar código base. A requisição e o código são gerados localmente; rodar envia sua chave e seu prompt direto para o Google.
Recursos
- Monta requisições POST generateContent do Google Gemini para o endpoint v1beta com a chave na query string
- Seletor de modelo com sugestões gemini-1.5-flash, gemini-1.5-pro e gemini-2.0-flash
- Gera automaticamente o corpo JSON correto de contents e parts a partir do seu prompt
- Cópia com um clique do código equivalente em cURL, Python e JavaScript
- O botão Rodar envia a chamada ao vivo e mostra a resposta JSON bruta ou o erro
- Botão de mostrar/ocultar para a chave de API, para que não fique visível por padrão
- A chave de API fica apenas na memória do navegador - nunca armazenada ou enviada à ArrayKit
- Link direto para o Google AI Studio para criar uma chave de API do Gemini
Como usar Google Gemini API Tester
- Cole sua chave de API do Gemini (começa com AIza) no campo da chave
- Escolha um modelo como gemini-1.5-flash ou digite o seu próprio
- Digite seu prompt na caixa Prompt
- Pressione Rodar para enviar a requisição e ler a resposta, ou troque a aba de código e copie o cURL, Python ou JavaScript
- Se o navegador bloquear a chamada, copie o cURL e rode-o em um terminal
Exemplo
Entrada
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=YOUR_GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Write a haiku about TypeScript."}]}]}'
Saída
{
"candidates": [
{ "content": { "parts": [{ "text": "Types guard the morning..." }], "role": "model" } }
]
}
Uma requisição mínima generateContent do Gemini e o formato de sua resposta.
Erros comuns e solução de problemas
- O navegador bloqueia o Rodar com um erro de CORS ou de rede. — Os navegadores nem sempre conseguem chamar o endpoint do Gemini diretamente. Copie o cURL ou Python gerado e rode-o em um terminal ou no seu servidor.
- 400 API key not valid, ou PERMISSION_DENIED. — Verifique se a chave do Google AI Studio está colada corretamente e se a Generative Language API está habilitada para esse projeto.
- 404 modelo não encontrado. — Use um id de modelo válido como gemini-1.5-flash, gemini-1.5-pro ou gemini-2.0-flash; nomes antigos ou restritos por região podem dar 404.
- 429 RESOURCE_EXHAUSTED / cota excedida. — Você atingiu um limite de taxa ou de cota. Aguarde e tente novamente, ou aumente a cota no Google Cloud para o seu projeto.
- Chave visível no trecho copiado. — A chave do Gemini fica na query string da URL, então aparece no cURL. Nunca a coloque em commit nem a cole em algum lugar público; use uma variável de ambiente em código real.
Perguntas frequentes
- O que é o Testador da API Gemini?
- É uma ferramenta da ArrayKit que monta requisições generateContent do Google Gemini a partir de uma chave, modelo e prompt, permite rodá-las e copia o cURL, Python e JavaScript equivalentes para que você teste a API rapidamente.
- Minha chave de API do Gemini é enviada à ArrayKit?
- Não. A requisição e o código são construídos localmente no seu navegador. Quando você pressiona Rodar, sua chave e seu prompt vão diretamente do seu navegador para o endpoint generativelanguage.googleapis.com do Google - nunca para a ArrayKit. A chave fica apenas na memória do navegador e nunca é armazenada.
- Por que Rodar falha com um erro de CORS quando o cURL funciona?
- O Google pode bloquear chamadas diretas de origem do navegador à API do Gemini. O cURL ou Python gerado roda em um terminal ou servidor, onde o CORS não se aplica, então use isso para confirmar a chamada.
- Quais modelos Gemini posso testar?
- O campo de modelo sugere gemini-1.5-flash, gemini-1.5-pro e gemini-2.0-flash, e você pode digitar qualquer outro id de modelo ao qual sua chave tenha acesso.
- Onde a chave de API é colocada em uma requisição do Gemini?
- O Gemini recebe a chave como um parâmetro de query string ?key= na URL v1beta de generateContent, não em um cabeçalho Authorization, então ela aparece na URL e no cURL copiados.
- É seguro usar minha chave de produção aqui?
- Evite chaves de produção em máquinas compartilhadas ou públicas. A chave fica apenas na memória do navegador deste dispositivo, mas é incluída nos trechos copiados, então prefira uma chave restrita ou de teste e rotacione-a se for exposta.
Ferramentas relacionadas
- OpenAI API Tester — Build, run and copy OpenAI Chat Completions API requests as cURL, Python and JavaScript.
- Anthropic Claude API Tester — Build, run and copy Anthropic Claude Messages API requests as cURL, Python and JavaScript.
- Replicate API Tester — Build, run and copy Replicate prediction API requests as cURL, Python and JavaScript.
- Hugging Face API Tester — Build, run and copy Hugging Face Inference API requests as cURL, Python and JavaScript.
- Cliente de API — Envie requisições HTTP, monte cabeçalhos e parâmetros e inspecione respostas; salva as últimas 25.
- cURL para Fetch — Converta um comando curl em uma chamada fetch() de JavaScript.
- Analisador de URL — Decomponha uma URL em suas partes e liste os parâmetros de consulta.
- Formatador de JSON — Embeleze, minifique e valide JSON com a localização dos erros.
Todas as ferramentas de ArrayKit