Chave de API Gemini: obter, configurar e testar

01Crie uma chave de API OmniaKey

Entre na conta, abra Chaves de API e crie uma chave para sua aplicação. Revise a cota, a validade e as restrições de modelos. Adicione saldo antes de executar pedidos de geração.

02Defina a chave e a URL da API

Execute os comandos no seu próprio terminal e substitua o espaço reservado pela sua chave. Mantenha a chave no servidor ou em um gerenciador de segredos. Nunca a coloque em código de navegador ou em um repositório público.

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Verifique a autenticação

Solicite a lista de modelos sem iniciar uma tarefa de geração. Uma resposta bem-sucedida é um JSON com um array data. Isso verifica o acesso da chave; não confirma que todos os modelos estão habilitados para sua conta.

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Use o formato de requisição do modelo

Selecione um modelo na página da família, copie o ID da API e siga a documentação correspondente. A autenticação sozinha não verifica seus parâmetros de geração.

Seu cliente precisa ser compatível com o protocolo usado pelo modelo escolhido. Confira a documentação do modelo antes de alternar entre Chat Completions, Responses ou um endpoint nativo do provedor.

Exemplo de pedido de geração (cobrado)

Este pedido usa o saldo da sua conta. Confira antes o preço do modelo escolhido. O exemplo segue o formato de requisição documentado; sua conta ainda precisa ter acesso ao modelo.

curl --fail-with-body 'https://api.omniakey.com/v1beta/models/gemini-4-argon:generateContent' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain what an API key does in one sentence."
        }
      ]
    }
  ]
}'