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:-
Node.js e npm instalados
Baixe e instale do site do Node.js (v16 ou superior recomendado) -
Chave de API do APIMart
Faça login no Console do APIMart e copie sua chave de API (começa comsk-)
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: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):2.2 Variáveis de ambiente permanentes (recomendado)
Persista a configuração para que novos shells a captem automaticamente. Windows (PowerShell):- Execute o PowerShell como Administrador
- Defina variáveis de ambiente no nível do usuário:
- Reinicie o PowerShell ou recarregue as variáveis:
- Edite o arquivo rc do seu shell:
- Anexe:
- Recarregue:
2.3 Usando um arquivo .env
Crie um arquivo .env no seu projeto:
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 commitadas2.4 Verificar a configuração
macOS/Linux:Etapa 3: Usar o Gemini CLI
3.1 Chat básico
Sessão interativa:3.2 Escolher um modelo
3.3 Ler prompts de um arquivo
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
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
-
Formato da chave
- Deve começar com
sk- - Sem espaços extras ao colar
- Deve começar com
-
Variáveis de ambiente
-
Status da chave
- Verifique a chave no Console do APIMart
- Verifique se sua conta tem saldo
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# / .NET —
HttpClient - ✅ Swift —
URLSession - ✅ 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
- 📚 Documentação do APIMart
- 📚 Documentação do Google AI Studio
- 💬 Discord
- 🐦 Twitter @APIMart_
- 📧 zhihong@apimart.ai
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.