A URL base é a raiz do gateway
O SDK do Gemini acrescenta o caminho /v1beta sozinho, por isso defina o URL raiz sem caminho de versão.
Gemini CLI
Utilize o Gemini CLI através do Aiduct.
O Gemini CLI e o SDK @google/genai enviam os pedidos generateContent do Gemini para o URL base que definir. O Aiduct responde em /v1beta com a mesma chave de API que utiliza em tudo o resto.
VARIÁVEIS DE AMBIENTE DO GEMINI CLI
export GOOGLE_GEMINI_BASE_URL=https://api.aiduct.ai export GEMINI_API_KEY=sk-aiduct-... gemini --model gemini-3.7-flash
VAR. DE AMBIENTE
GOOGLE_GEMINI_BASE_URL
PROTOCOLO
generateContent
ENDPOINT
/v1beta
Qualquer modelo do catálogo, não apenas o Gemini
Os modelos Gemini são servidos de forma nativa. Os restantes modelos são traduzidos de e para generateContent, mantendo as chamadas de função e o raciocínio.
FAQ
GOOGLE_GEMINI_BASE_URL deve incluir /v1beta?+
Não. Utilize https://api.aiduct.ai; o SDK do Gemini acrescenta /v1beta sozinho.
Como é que o Gemini CLI envia a chave do Aiduct?+
No cabeçalho x-goog-api-key, que o Aiduct aceita como um token Bearer.
O countTokens do Gemini funciona?+
Sim. Um modelo servido de forma nativa é contado pelo respetivo upstream; qualquer outra contagem é uma estimativa, assinalada pelo cabeçalho x-aiduct-token-count: estimated.