Testador da API Google Gemini para montar, rodar e copiar requisições generateContent como cURL, Python e JavaScript.
Testador da API Gemini
Testador da API Google Gemini para montar, rodar e copiar requisições generateContent como cURL, Python e 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.
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 Testador de API do Google Gemini
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."}]}]}'
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 no endpoint do Gemini 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
Testador de API da OpenAI — Crie, execute e copie requisições à API Chat Completions da OpenAI como cURL, Python e JavaScript.