A compra corporativa da Gemini API costuma ser resumida a "quanto custa por milhão de tokens". O que realmente decide se um projeto entra em produção é a cota, a taxa, os termos de dados, a gestão de contas e chaves, a conciliação da fatura e a existência de um plano B quando o canal principal falha.

Este artigo apresenta um checklist na ordem de compra e lançamento. Modelos e preços específicos seguem a página de preços do site e a documentação do Google; o texto não fixa preços unitários nem emite conclusão jurídica por nenhuma das partes.

Nota: Google e Gemini são marcas da Google LLC. Termos, regiões e regras de cota do Google AI Studio e do Vertex AI podem ser diferentes; vale o contrato assinado, os termos oficiais e a configuração efetiva do console. O ZSQH AI Gateway é um gateway de API independente de terceiros; este artigo discute apenas métodos de acesso e compra.

1. Calcule a carga de trabalho antes de falar em cota

Antes de comprar, responda a quatro perguntas; sem isso, a cota será apenas um chute.

  1. Quantas requisições há por dia e em que horário o pico se concentra?
  2. Quantos tokens tem, em média, a entrada e a saída? Qual o tamanho dos 5% mais longos?
  3. Que proporção de imagens, áudio, vídeo e PDF existe, e qual o tamanho de cada material?
  4. Quantas requisições extras vêm de retries, falhas e reenvio de histórico?

Agrupe os logs da última semana por modelo, tipo de tarefa e tamanho de entrada, calcule requisições diárias, tokens diários e concorrência de pico, multiplique por 30 para obter a linha de base mensal e acrescente 20% a 30% de margem para retries. Para projetos novos sem logs, rode uma semana com pouco tráfego; não estime apenas por "número de usuários × chamadas".

2. Cota, taxa e fatura

O nível gratuito do AI Studio serve para validação, mas tem taxa e cota mais restritas, e os termos de dados também podem diferir. Planeje produção no nível pago e registre no pedido de compra:

  • Se a entidade de liquidação é uma conta internacional ou uma empresa local, e como moeda e câmbio são tratados.
  • Se o modelo é pré-pago ou pós-pago, e como configurar alertas de saldo e recarga automática.
  • Se a cota é alocada por projeto ou por equipe, e quem pode solicitar aumento temporário.
  • A estratégia de retry, fila e degradação quando aparece 429.
  • Tipo de nota fiscal, periodicidade de emissão e campos necessários para conciliação.

O acesso oficial direto normalmente liquida em dólar e serve equipes que já têm processo de pagamento internacional; quem precisa de nota fiscal local e fatura unificada de vários modelos pode avaliar um gateway local. As duas rotas têm estruturas de custo diferentes; não compare apenas o preço de tabela.

3. Dados e conformidade: pergunte antes de assinar

O limite de conformidade depende de qual entrada é usada, quais recursos são ativados e em que região os dados ficam. Monte uma lista escrita de perguntas e envie para jurídico, segurança e negócio avaliarem:

  1. Entradas e saídas são usadas para treinar modelos? Os termos corporativos têm disposição diferente?
  2. Por quanto tempo os dados são retidos, como solicitar exclusão e em quanto tempo ela passa a valer?
  3. Em que regiões os dados ficam armazenados e isso atende a requisitos de residência da empresa ou do cliente?
  4. É possível assinar um acordo de tratamento de dados? Como ficam limite de responsabilidade e teto de indenização?
  5. Quais são os subprocessadores e há aviso prévio em caso de mudança?
  6. Logs, cache e upload de arquivos vêm ativados por padrão? Podem ser desativados ou ter retenção reduzida?

Não aceite resposta verbal. Arquite a política de privacidade, o acordo de tratamento de dados, a descrição de segurança e a lista de subprocessadores como material de aceite. Em caso de dados pessoais ou transferência internacional, anonimize primeiro e peça ao jurídico para confirmar o caminho.

4. Conta, permissões e gestão de chaves

O maior risco em conta corporativa é "uma chave para a empresa inteira". Sugere-se a seguinte ordem:

  1. Registrar com e-mail de domínio corporativo, vincular a organização à pessoa jurídica e não usar conta pessoal para o negócio.
  2. Separar projetos Cloud ou workspaces de produção, teste e desenvolvimento, com fatura e cota próprias.
  3. Dar permissão de administrador a poucas pessoas, ativar autenticação em dois fatores e revisar membros trimestralmente.
  4. Usar contas de serviço ou chaves independentes nas chamadas de negócio, nunca credenciais de administrador.
  5. Identificar em cada chave responsável, finalidade, ambiente e data de criação; revogar no desligamento.
  6. Ativar logs de auditoria e alertas de consumo; em chamada anômala, suspender a chave antes de investigar.

Chaves ficam apenas em variável de ambiente no servidor ou em gerenciador de segredos, nunca no front-end, no repositório ou em capturas de tela de chamados. Use uma chave separada de baixa cota para demonstrações e exclua-a ao final.

5. Controle de custos: comece pela arquitetura, não só pelo fornecedor

O custo da Gemini é determinado pela faixa do modelo, tamanho de entrada e saída, materiais multimodais e retries. A ordem deve ser: governar a entrada, depois fazer roteamento em camadas e só então comparar preço unitário.

  • Fixe o system prompt e o prefixo de documentos longos e use cache de contexto para reduzir entrada repetida.
  • Classificação, extração e reescrita vão para faixas leves; raciocínio complexo sobe de faixa.
  • Defina maxOutputTokens e exija JSON ou campos fixos, evitando respostas prolixas.
  • Reduza a resolução de imagens, diminua a taxa de extração de quadros de vídeo e envie apenas as páginas relevantes de PDFs.
  • Tarefas offline vão para processamento em lote, aceitando fila em troca de custo menor.
  • Limite retries com backoff; durante 429, não amplie o volume de requisições.
  • Registre consumo por projeto, equipe e tarefa para rateio interno.

Após conectar o gateway, é possível usar o SDK da OpenAI de forma unificada e conferir o consumo na resposta:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="<nome do modelo Gemini na página de preços>",
    messages=[{"role": "user", "content": "Responda apenas OK"}],
    max_tokens=64,
)

print(resp.usage)

O nome do modelo segue a página de preços; não reutilize nomes de documentação antiga. Antes de lançar uma tarefa, meça com amostras reais o "custo de concluir uma tarefa com qualidade", não apenas o preço de uma requisição.

6. Fornecedor reserva e plano de degradação

A compra corporativa deve assumir que o canal principal vai oscilar. Prepare ao menos três camadas: modelo reserva do mesmo fornecedor, modelo de outro fornecedor e fallback de negócio, como mensagem de degradação ou resultado em cache.

Abstraia a chamada de modelo em uma interface única, com timeout, retry, disjuntor e interruptor de troca; a troca deve ocorrer em até um minuto e sem alterar o código de negócio. Ensaie trimestralmente e confirme que chave, cota e nome de modelo do canal reserva são válidos. O contrato deve definir nível de serviço e condições de saída.

7. Piloto e aceite: plano de avaliação de quatro semanas

Recomenda-se um piloto de quatro semanas em escopo reduzido, evitando migração total de uma vez.

Etapa Responsável R Aprovação A Consulta C Informação I Entregável
Requisitos e estimativa de cota Dono do negócio Chefe de área Finanças, tecnologia Compras Tabela de linha de base de consumo
Avaliação de dados e conformidade Segurança e conformidade Jurídico Tecnologia, compras Diretoria Lista de riscos e conclusão
Configuração de conta e permissões Administrador de plataforma Líder técnico Segurança Negócio Lista de projetos e chaves
Integração técnica e teste de carga Líder de desenvolvimento Líder técnico Operações Negócio Relatório de integração e registros de teste
Monitoramento de custos e conciliação Finanças Responsável financeiro Tecnologia, compras Diretoria Relatório semanal de custos
Contrato e pagamento Compras Responsável financeiro Jurídico Negócio Contrato, nota fiscal e comprovante
Aceite de lançamento Dono do negócio Chefe de área Tecnologia, segurança Diretoria Termo de aceite assinado

Na primeira semana, valide interface e permissões; na segunda, compare qualidade com amostras reais; na terceira, faça teste de carga no pico e simulação de falha; na quarta, consolide custos e submeta o aceite. Os indicadores incluem acurácia da tarefa, latência P95, taxa de erro e de retry, custo por tarefa e verificação de chaves e permissões; os limites específicos são definidos pela equipe conforme o negócio.

8. Perguntas para o contrato

  1. Como o nível de serviço é definido, qual o critério estatístico e como funciona a compensação?
  2. Com quanta antecedência mudanças de preço são comunicadas e a cota já comprada é afetada?
  3. Qual o processo e o prazo de resposta para solicitar aumento de cota?
  4. O acordo de tratamento de dados, as restrições regionais e o fluxo de exclusão podem constar do contrato?
  5. Tipo de nota fiscal, moeda, prazo de pagamento e regras de reembolso?
  6. Quais os canais de suporte, tempos de resposta e caminho de escalonamento?
  7. Após o encerramento, como os dados são exportados e excluídos?
  8. Como mudanças de subprocessadores e incidentes de segurança são comunicados?

Perguntas frequentes

A compra corporativa da Gemini API exige Vertex AI?

Não necessariamente. Equipes com exigências fortes de região de dados, IAM, auditoria e entidade contratante se ajustam melhor ao Vertex AI; validação rápida e operações pequenas podem começar pelo AI Studio. Confirme primeiro se termos e cotas atendem ao negócio e depois escolha a entrada.

A cota gratuita pode ser usada em produção?

Não é recomendável. Taxa, cota e termos de dados do nível gratuito costumam diferir do nível pago, e uma limitação repentina afeta a experiência. Planeje produção no nível pago e use o gratuito apenas para protótipos e testes internos.

Os dados da Gemini API são usados para treinamento?

A resposta pode variar conforme produto, termos e configuração. Vale o acordo de tratamento de dados e os termos oficiais; em dados sensíveis, anonimizze antes e peça ao jurídico para confirmar retenção e cláusulas de treinamento.

E se a cota não bastar ou aparecerem muitos 429?

Primeiro distinga limite de taxa de limite total de cota; depois otimize retry, concorrência e tamanho das requisições. Só solicite aumento ou adicione canal reserva após confirmar que o crescimento é do negócio. Reenviar sem critério só piora.

Como provar que o custo ficou controlável após a compra?

Crie a linha de base de consumo antes do lançamento e, depois, emita relatórios semanais por projeto, acompanhando custo por tarefa, acerto de cache, taxa de retry e proporção de faixas. Só é controlável se ficar quatro semanas seguidas dentro do orçamento e com qualidade aceitável.

Próximo passo

Crie uma chave de teste no ZSQH AI Gateway com tarefas reais, valide modelos, latência e fatura em moeda local e depois separe as chaves oficiais por ambiente. Preços seguem a página de preços; antes de comprar, peça a finanças, jurídico e tecnologia para revisar o checklist.

Leituras relacionadas: