Skip to main content

Introdução

Gemini CLI é a ferramenta oficial de linha de comando do Google que permite aos desenvolvedores interagir com os modelos de IA Gemini a partir do terminal. Após configurar a API do APIMart, você pode usar os modelos avançados do APIMart — GPT, Claude e Gemini — no Gemini CLI.

Pré-requisitos

Antes de começar:
  1. Node.js e npm instalados
    Baixe e instale do site do Node.js (v16 ou superior recomendado)
  2. Chave de API do APIMart
    Faça login no Console do APIMart e copie sua chave de API (começa com sk-)
Dica: Se você ainda não tem uma conta no APIMart, registre-se primeiro em APIMart e crie uma chave de API.

Etapa 1: Instalar o Gemini CLI

1.1 Instalação global

Instale o Gemini CLI globalmente com o npm:

1.2 Verificar a instalação

Verifique se o CLI está disponível:
Se um número de versão for impresso, a instalação foi bem-sucedida.
Dica: Se o comando não for encontrado, reinicie o terminal ou verifique a configuração global do PATH do npm.

Etapa 2: Configurar a API do APIMart

2.1 Variáveis de ambiente temporárias

Para testes ou uso único; os valores são limpos quando você fecha o terminal. Windows (PowerShell):
macOS/Linux (Bash):

2.2 Variáveis de ambiente permanentes (recomendado)

Persista a configuração para que novos shells a captem automaticamente. Windows (PowerShell):
  1. Execute o PowerShell como Administrador
  2. Defina variáveis de ambiente no nível do usuário:
  1. Reinicie o PowerShell ou recarregue as variáveis:
macOS/Linux (Bash):
  1. Edite o arquivo rc do seu shell:
  1. Anexe:
  1. Recarregue:

2.3 Usando um arquivo .env

Crie um arquivo .env no seu projeto:
Carregue as variáveis antes de executar o Gemini: macOS/Linux:
Windows (PowerShell):
Importante: - Substitua sk-xxxxxxxxxxxx pela sua chave real do Console do APIMart - Defina GEMINI_BASE_URL como https://api.apimart.ai/v1 para que o Gemini CLI se comunique com o APIMart - Adicione .env ao .gitignore para que as chaves não sejam commitadas

2.4 Verificar a configuração

macOS/Linux:
Windows (PowerShell):
Se os valores parecerem corretos, a configuração foi bem-sucedida.

Etapa 3: Usar o Gemini CLI

3.1 Chat básico

Sessão interativa:
Prompt único:

3.2 Escolher um modelo

Ou:

3.3 Ler prompts de um arquivo

Ou via pipe:

3.4 Salvar saída em um arquivo

Etapa 4: Chamar o APIMart a partir do seu código

4.1 Python SDK

4.2 JavaScript / TypeScript

4.3 cURL

Etapa 5: Escolher um modelo

Modelos recomendados

O APIMart suporta muitos modelos; escolha por tarefa e orçamento. Gemini GPT Claude
Escolhas rápidas: - 🚀 Stack estilo Google: gemini-2.0-flash-exp, gemini-2.5-pro - 💡 Programação: claude-sonnet-4-5-20250929, gpt-5 - 💰 Custo: gpt-4o-mini, claude-haiku-4-5-20251001 - ⚡ Velocidade: gemini-2.0-flash-exp, gpt-4o-mini

Recursos avançados

Multimodal (imagens)

Com um modelo multimodal como Gemini 2.0 Flash:

Streaming

Transmita tokens conforme chegam:

Ajustando parâmetros

Modele aleatoriedade e comprimento:

FAQ

Q1: “Invalid API key” ou erros de autenticação

  1. Formato da chave
    • Deve começar com sk-
    • Sem espaços extras ao colar
  2. Variáveis de ambiente
  3. Status da chave

Q2: Como verificar a configuração da API?

Q3: Quais linguagens são suportadas?

Qualquer linguagem que possa enviar requisições HTTP funciona com o APIMart:
  • Python — OpenAI SDK recomendado
  • JavaScript / TypeScript — Node ou navegador
  • Java — cliente HTTP
  • Go — stdlib ou bibliotecas
  • PHP — cURL ou Guzzle
  • Ruby — gems HTTP
  • C# / .NETHttpClient
  • SwiftURLSession
  • Outras — qualquer uma com HTTP

Q4: Onde posso ver o uso e o faturamento?

No Console do APIMart:
  • 📊 Estatísticas de chamadas ao vivo
  • 💰 Custo e faturas
  • 📈 Tendências de uso
  • 🔍 Logs de requisições
  • ⚙️ Gerenciamento de chave de API

Q5: Erros comuns de API

Melhores práticas

1. Retentativas e backoff

2. Controle de custos

3. Prompts de sistema

Recursos

Com Google AI Studio e APIMart você obtém:
  • 🤖 Muitos modelos — GPT, Claude, Gemini e mais
  • 🌍 Compatível com OpenAI — formato familiar de requisição/resposta
  • Desempenho — baixa latência, alta concorrência
  • 💰 Preços claros — pague conforme usar
  • 📊 Observabilidade — monitore chamadas em tempo real
  • 🔒 Segurança — proteções voltadas para empresas
  • 🚀 Integração rápida — chamadas HTTP / SDK simples
  • 📚 Documentação — guias e exemplos

Suporte


Comece a usar o APIMart

Crie uma conta, obtenha uma chave de API e use vários modelos de IA a partir dos fluxos de trabalho do Google AI Studio e além.