Gemini API em formato compatível com OpenAI

Usar a Gemini API diretamente significa ter uma conta Google, criar uma chave no Google AI Studio e pagar conforme a cobrança do Google. Aqui essa parte é substituída: você recarrega o saldo na RelaySwitch, usa a chave da RelaySwitch, e a requisição vai para o gateway, que a encaminha ao Gemini. Para o seu código, só mudam o endereço e a chave; o id do modelo continua sendo o id do Gemini.

O Gemini tem um formato de requisição próprio (generateContent), mas a maior parte das ferramentas e do código que já existe foi escrita para OpenAI Chat Completions. O próprio Google oferece uma camada compatível com OpenAI e registra na documentação que esse suporte ainda está em beta. A abordagem aqui é a mesma: todo id de Gemini da tabela de preços pode ser chamado no formato OpenAI, então migrar código OpenAI para o Gemini é só trocar o campo model.

Confirme com curl que a chave e o endereço estão corretos. A chave vai no header Authorization: Bearer, e em relação a um exemplo comum da OpenAI só mudam a Base URL, a chave e o model.

A Base URL é escrita com /v1, e o SDK acrescenta /chat/completions por conta própria. Para streaming, defina stream como true; a resposta chega como server-sent events, no mesmo formato da OpenAI. A contagem de tokens em usage é a mesma registrada no recibo.

Código escrito seguindo a documentação de compatibilidade com OpenAI do Google já usa o SDK da OpenAI, então o corpo da requisição não precisa mudar. Os campos específicos do Gemini que a documentação do Google envia por extra_body não foram testados um a um nesta página; se você os usa, teste primeiro com uma requisição e veja se a cobrança no recibo é a esperada.

Só três coisas mudam:

• base_url: do endereço da documentação do Google para https://api.relayswitch.io/v1.
• api_key: da chave do Google AI Studio para a chave da RelaySwitch, que começa com sk-relay-.
• model: confira o id na tabela de preços desta página e use o que estiver escrito no momento; um id errado recebe 404 model_not_found.

Programas já escritos no formato de requisição do Google não precisam ser reescritos, desde que o id de Gemini usado atenda essa rota. O caminho é /v1beta/models/{model}:generateContent, logo depois de https://api.relayswitch.io, sem /v1. A chave vai no header x-goog-api-key, não na URL: uma chave colocada em query parameter é recusada pelo gateway. O corpo da requisição e a resposta usam a estrutura do Google, com contents na entrada e candidates na saída.

As mensagens de erro seguem cada formato. No formato OpenAI, o código fica em error.code; no formato nativo, a forma segue a do Google, por exemplo um 401 com error.status igual a UNAUTHENTICATED quando a chave não é enviada. Os dois formatos usam a mesma chave, o mesmo saldo e o mesmo preço. A tabela de códigos de erro por status está na página OpenAI API e vale integralmente quando o Gemini é chamado no formato OpenAI.

Em USD por milhão de tokens, lidos do catálogo quando a página é renderizada. A cobrança usa três preços: entrada, entrada em cache e saída, e o preço da tabela é o preço debitado do saldo.

O Gemini é muito usado para ler material longo: um contrato inteiro, um repositório de código ou a transcrição de uma reunião. O custo de uma requisição assim está quase todo na entrada, então, ao escolher o modelo, olhe primeiro o preço de entrada e o tamanho do contexto, e só depois o preço de saída. Se o mesmo material recebe várias perguntas, a parte repetida cai no cache a partir da segunda requisição e é cobrada pelo preço de entrada em cache; o recibo registra esses tokens separadamente.

Um nome de modelo com a palavra preview indica uma versão prévia, que depois o Google substitui por um nome definitivo, então o id escrito no código deve seguir o que estiver na tabela no momento. Para escolher o modelo não é preciso adivinhar: todos os ids de Gemini estão na mesma chave, então envie o mesmo prompt a cada um e compare as respostas e o custo nos recibos. Comparar com o GPT ou com o Claude também é só trocar o model.

Para produção, crie uma chave separada, dê a ela um orçamento em dólares e um limite de gasto diário, e restrinja-a com uma allowlist de modelos aos ids de Gemini que você escolheu. Programas que leem documentos longos são os que mais precisam desse limite, porque uma requisição que envia por engano um diretório inteiro pode levar centenas de milhares de tokens de entrada. Em requisições que falham, leia o header retry-after antes de tentar de novo. A criação da chave e a configuração dos limites estão na página Claude API key.