Gemini BYOK não desativa o armazenamento de requisições no Google
Conteúdo
- Qual é a relação entre BYOK, Vertex e Developer API?
- Onde configurar o BYOK e o armazenamento de requisições?
- O que mudou no armazenamento de requisições do Gemini?
- Um endpoint Custom pode chamar a Gemini Developer API?
- store=false funciona na Developer API nativa?
- O que os testes de controle locais verificaram?
- O fallback pode mudar o tratamento de dados do projeto?
- O que verificar antes de usar em produção?
- Perguntas frequentes
- O Gemini BYOK desativa os logs de requisições?
- Devo configurar o BYOK por parâmetros da requisição de inferência?
- store=false significa retenção zero de dados?
- Desativar o fallback garante que todas as requisições permaneçam no meu projeto?
O Gemini BYOK (bring your own key) define quais credenciais do cliente serão usadas; ele não desativa o armazenamento de requisições. Para o caminho pelo gateway testado aqui, configure o BYOK no console da Synthorai e a política de armazenamento no projeto Google associado. Nos testes, a API do Google compatível com Chat rejeitou store=false no nível superior, e a conversão de uma requisição nativa do Gemini para Chat omitiu o campo.
TL;DR
- Gemini é uma família de modelos. Gemini Developer API e Vertex AI são serviços distintos do Google para acessar esses modelos.
- A configuração padrão de Google BYOK na Synthorai usa o Vertex; um endpoint Custom configurado separadamente pode usar a interface da Developer API compatível com Chat.
- Configure as credenciais e o fallback do gateway no console da Synthorai; configure os logs do projeto da Developer API no Google AI Studio.
- Em seis testes síncronos pelo gateway, valores booleanos explícitos de armazenamento no formato Chat retornaram 400; a conversão do formato nativo para Chat omitiu esses valores, e as requisições bem-sucedidas apareceram nos logs do AI Studio.
Qual é a relação entre BYOK, Vertex e Developer API?
BYOK define de quem são as credenciais usadas pelo gateway. Vertex AI e Gemini Developer API identificam o serviço do Google que recebe a requisição. Um nome de modelo que contém Gemini não identifica o serviço nem sua política de armazenamento.
| Serviço do Google | Host da API do Google | Configuração na Synthorai | Controles de armazenamento a revisar |
|---|---|---|---|
| Gemini no Vertex AI | aiplatform.googleapis.com, incluindo hosts regionais | Configuração padrão de Google BYOK, identificada como Vertex, com uma credencial autorizada para o Vertex | Controles de logs e retenção específicos do serviço no projeto Google Cloud selecionado |
| Gemini Developer API | generativelanguage.googleapis.com | Endpoint Custom separado, usando a interface do Google compatível com OpenAI e uma chave da Developer API | Logs do projeto no AI Studio; opções por requisição aceitas pela interface da API utilizada |
Um endpoint Custom é uma configuração do gateway, não um terceiro serviço do Google. Ele define a URL de destino, o formato da API, a chave do cliente e a lista de modelos. A interface compatível com Chat do Google é uma das interfaces da Developer API; a interface nativa GenerateContent usa outro formato de requisição.
A configuração padrão de BYOK para Vertex não tem um campo dedicado à chave da Gemini Developer API. Uma conta de serviço do Google Cloud, normalmente usada no Vertex, é uma identidade de aplicação com permissões no projeto. Uma chave da Developer API identifica uma configuração de serviço diferente. Use credenciais autorizadas para o destino selecionado.
Os experimentos abaixo usam a Developer API. Para o Vertex, consulte os controles de retenção específicos do serviço do Google; a mudança nos logs da Developer API não determina o comportamento do Vertex.
Onde configurar o BYOK e o armazenamento de requisições?
Configure as credenciais do cliente no console da Synthorai e depois revise o armazenamento no console do serviço Google selecionado. Essas configurações controlam partes diferentes do caminho da requisição.
| Onde | O que configurar |
|---|---|
| Console da Synthorai, BYOK | Credencial do cliente ou endpoint Custom, modelos pretendidos, estado de ativação e política de fallback |
| Google AI Studio, projeto da Developer API | Armazenamento de requisições GenerateContent e retenção de logs |
| Google Cloud, projeto do Vertex | Controles de logs e retenção do serviço correspondente |
Siga o guia de BYOK para configurar o gateway. Depois, as aplicações usam a chave de API do gateway nas chamadas de inferência comuns. Defina explicitamente a lista de modelos de um endpoint Custom: conforme o comportamento documentado, uma lista vazia faz o endpoint assumir todos os modelos. Use nomes de modelos aceitos por esse endpoint, pois os aliases da plataforma podem ser diferentes.
Para o caminho testado com um endpoint Custom da Developer API, use a configuração do projeto Google para definir a política de logs da aplicação. O Google documenta como ativar e desativar os logs do projeto no AI Studio. Se você desativar os logs, verifique o resultado com requisições sintéticas antes de usar prompts sensíveis. Nos nossos testes, o armazenamento estava ativado; não avaliamos a configuração desativada.
O controle por requisição continua válido na API nativa GenerateContent do Google, em que um valor de store aceito pela API prevalece sobre a configuração do projeto. O gateway não garante compatibilidade com esse parâmetro específico do Google no caminho compatível com Chat testado aqui. Os resultados a seguir explicam por que a configuração no backend é o controle recomendado para esta integração.
O que mudou no armazenamento de requisições do Gemini?
Novos projetos pagos da Gemini Developer API agora armazenam requisições Generate Content, a menos que o chamador ou a configuração do projeto desative o armazenamento. Projetos criados antes de 26 de outubro mantêm a configuração existente. Criar uma chave em um projeto antigo não cria um projeto novo nem determina qual padrão de logs se aplica. O Google documenta a mudança nas notas de versão de 26 de outubro.
A propriedade store da requisição tem precedência sobre o padrão do projeto. O guia de logs cobre chamadas Generate Content síncronas, com streaming e em lote, incluindo chamadas pela interface do Google compatível com OpenAI. Os logs armazenados no projeto têm retenção padrão de 55 dias, com períodos configuráveis de 7, 14, 28 ou 55 dias. Salvar um log em um dataset altera esse ciclo de vida.
O armazenamento de requisições também é independente do uso para treinamento e dos logs de segurança. Os termos dos serviços pagos do Google dizem que prompts e respostas pagos não são usados para melhorar seus produtos e descrevem uma retenção limitada para proteção e segurança. Desativar o log da aplicação atua sobre um mecanismo específico de armazenamento.
Um endpoint Custom pode chamar a Gemini Developer API?
O pipeline isolado de endpoint Custom da Synthorai chamou o Gemini 3.5 Flash-Lite com sucesso pelo endpoint do Google compatível com Chat quando store foi omitido. O Google retornou HTTP 200 e OK, e o gateway retornou HTTP 200 ao cliente. Com store=true ou store=false explícito no nível superior, o Google retornou HTTP 400, indicando uma requisição inválida.
O ambiente isolado de teste usou estes valores na configuração do endpoint Custom:
| Configuração | Valor |
|---|---|
| Tipo de API do endpoint | OpenAI Chat Completions (openai_chat) |
| URL base do Google | https://generativelanguage.googleapis.com/v1beta/openai |
| Credencial | Chave existente da Gemini Developer API, enviada com autenticação Bearer |
| Lista de modelos | Apenas gemini-3.5-flash-lite |
| Fallback para a plataforma | Desativado |
O gravador confirmou que as requisições do cliente no formato Chat preservavam cada booleano explícito no JSON de saída. O erro do Google foi Invalid JSON payload received. Unknown name "store": Cannot find field. Esse resultado se refere ao campo no nível superior do formato Chat; ele não demonstra que todas as possíveis extensões específicas do Google sejam incompatíveis.
A matriz síncrona final mostra como o formato da requisição do cliente afetou a transmissão:
| Formato da requisição do cliente | store de entrada | store no Chat de saída | HTTP Google / cliente | Log no AI Studio |
|---|---|---|---|---|
| Chat | true | true | 400 / 400 | Nenhuma resposta gerada |
| Chat | false | false | 400 / 400 | Nenhuma resposta gerada |
| Chat | Omitido | Omitido | 200 / 200 | Visível |
| Gemini nativo | true | Omitido | 200 / 200 | Visível |
| Gemini nativo | false | Omitido | 200 / 200 | Visível |
| Gemini nativo | Omitido | Omitido | 200 / 200 | Visível |
Cada linha representa uma requisição sintética para o mesmo modelo e projeto pago. Após as chamadas, a lista All datasets do AI Studio, sem filtros, mostrou os marcadores exatos dos quatro casos bem-sucedidos, incluindo o caso no formato nativo com store=false. O armazenamento de GenerateContent estava ativado no projeto. A conversão do formato nativo para Chat descartou a flag. A requisição chegou ao Google sem a opção de não armazenar solicitada e apareceu no log da aplicação.

As células de entrada da captura de tela estão truncadas; conferimos cada marcador completo na lista ao vivo. As três primeiras linhas correspondem ao formato nativo com o campo omitido, false e true, seguidas de Chat com o campo omitido. Isso confirma a visibilidade desses casos no log da aplicação, não o comportamento de todos os mecanismos de retenção do Google.
Executamos esses testes em 1 de novembro de 2026 (UTC), com um projeto pago existente e prompts sintéticos. O ambiente isolado do gateway forneceu uma identidade de teste de usuário/workspace e armazenamento temporário criptografado de credenciais. Um gravador local encaminhou ao Google, por HTTPS e sem alterações, o corpo de saída e a credencial Bearer do cliente. A configuração no console de produção, as verificações de URLs públicas de destino, a autenticação do cliente e o streaming ficaram fora do escopo do teste.
store=false funciona na Developer API nativa?
Chamadas diretas ao GenerateContent nativo com o Gemini 3.5 Flash-Lite aceitaram tanto store=true quanto store=false. Cada uma das duas requisições retornou HTTP 200, um ID de resposta e 32 tokens de entrada mais 1 token de saída. Cerca de 13 minutos depois, a lista completa do AI Studio mostrava o marcador de true e a saída OK; o marcador de false estava ausente. Esse teste de controle pareado mostra por que as interfaces nativa e compatível com Chat precisam ser verificadas separadamente.

Nas chamadas REST nativas, store é um booleano no nível superior, separado dos parâmetros de geração em generationConfig. A referência REST define essa estrutura. Este exemplo é uma requisição de controle enviada diretamente ao Google, separada da configuração de BYOK do gateway:
import json
import os
import secrets
import urllib.request
marker = "storage-check-" + secrets.token_hex(8)
body = {
"contents": [{"role": "user", "parts": [
{"text": f"Synthetic request {marker}. Reply only OK."}
]}],
"generationConfig": {"maxOutputTokens": 16},
"store": False,
}
request = urllib.request.Request(
"https://generativelanguage.googleapis.com/v1beta/"
"models/gemini-3.5-flash-lite:generateContent",
data=json.dumps(body).encode(),
headers={"Content-Type": "application/json",
"x-goog-api-key": os.environ["GEMINI_API_KEY"]},
method="POST",
)
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
print({"marker": marker, "response_id": result.get("responseId"),
"usage": result.get("usageMetadata")})
Procure o marcador nos logs do projeto autorizado após a requisição. Use um controle positivo com true antes de interpretar a ausência de um log com o marcador de false. HTTP 200 confirma que a requisição foi aceita; a observação do log confirma a visibilidade no log da aplicação consultado.
O projeto pago foi criado antes de 26 de outubro e estava com o armazenamento de GenerateContent ativado e a retenção exibida de 55 dias. Não alteramos nenhuma dessas configurações. Os detalhes individuais dos logs não carregaram no AI Studio, então usamos os campos de prompt, saída, modelo, status e timestamp da lista completa. Essas observações se referem aos logs da aplicação, não a todos os mecanismos de retenção do Google.
O que os testes de controle locais verificaram?
Nove casos com um gravador local cobriram os formatos de requisição Chat, Responses e Gemini nativo, cada um com store true, false e omitido. Chat e Responses preservaram os booleanos explícitos; a conversão de Gemini nativo para Chat os omitiu. Esses testes usaram credenciais sintéticas de cliente e receptores locais, sem chamadas ao Google.
Dois casos adicionais usaram um HTTP 503 controlado no endpoint do cliente. Com o fallback desativado, o cliente recebeu 503 e não houve nenhuma tentativa na plataforma. Com o fallback ativado, uma tentativa simulada na plataforma retornou 200. Isso verifica um cenário de falha, não todas as condições de ciclo de vida de credenciais ou fallback.
O fallback pode mudar o tratamento de dados do projeto?
O fallback pode enviar uma requisição usando credenciais com configurações de projeto diferentes. Para uma carga de trabalho restrita a um projeto, essa mudança precisa fazer parte da política configurada e de sua verificação.
A opção documentada da Synthorai para endpoints personalizados, Fallback automático para créditos da Synthorai, determina se a plataforma pode responder após uma falha nesse endpoint. A implementação também distingue a falha no provedor com uma chave elegível da ausência de uma chave ou do uso de uma chave inelegível. São caminhos diferentes no sistema.
| Cenário | O que verificar |
|---|---|
| Uma credencial de cliente configurada recebe um erro do provedor | Se o fallback permitido permanece dentro do conjunto aprovado de credenciais e serviços |
| A chave é removida ou desativada | Para onde vai a próxima requisição; o guia de BYOK documenta o fallback para credenciais compartilhadas após a remoção da chave |
| O modelo está fora do filtro de modelos da chave | Se a chamada é rejeitada ou usa outra credencial |
| A resolução de credenciais está indisponível | Se o sistema recusa a chamada ou segue seu comportamento de fallback para manter a disponibilidade |
| A requisição lista explicitamente um segundo modelo | Se esse modelo tem uma credencial e um serviço aprovados de forma independente |
Para uma carga de trabalho que deve permanecer em um único projeto, verifique se há rejeição sempre que nenhuma credencial e nenhum serviço aprovados estiverem disponíveis. Desativar apenas o fallback por falha no provedor não comprova esse comportamento para todas as linhas da tabela.
O que verificar antes de usar em produção?
Para ferramentas de desenvolvimento cujos prompts podem aparecer nos logs do AI Studio, o caminho testado com um endpoint Custom da Developer API concluiu as requisições quando store foi omitido. Configure as credenciais, a lista de modelos e a política de fallback no console do gateway e revise a configuração de logs do projeto Google associado.
Para cargas de trabalho que exigem logs da aplicação desativados, o controle de projeto documentado pelo Google é a configuração recomendada para esta integração com o gateway. Verifique o comportamento com os logs desativados no seu projeto; essa configuração não fez parte do experimento. Não remova um campo store=false rejeitado presumindo que a requisição manterá o mesmo comportamento de privacidade.
Para cargas de trabalho restritas a um projeto ou sensíveis, verifique também a titularidade das credenciais e todos os destinos de fallback, além de revisar a retenção de segurança, os caches e os logs na nuvem. O Vertex exige uma revisão separada dos próprios controles. A configuração de BYOK, por si só, não atesta essas condições.
Registre um marcador sintético, o projeto/serviço de destino, o campo final de armazenamento e o ID de resposta do provedor, quando disponível. Correlacione esses dados com os logs do provedor. Um rótulo final de cobrança BYOK não comprova o destino de cada tentativa anterior.
Para entender a cadeia de processamento mais ampla, consulte retenção de dados de LLMs e ZDR. Para correlacionar requisições, consulte traces e sessões.
Perguntas frequentes
O Gemini BYOK desativa os logs de requisições?
O Gemini BYOK é configurado no console do gateway para selecionar as credenciais do cliente. Os logs continuam sob o controle das configurações de projeto do serviço utilizado e das opções por requisição aceitas por ele. Revise o serviço de destino e sua configuração de logs.
Devo configurar o BYOK por parâmetros da requisição de inferência?
Configure o BYOK da Synthorai pelo console e depois envie chamadas de inferência comuns usando a chave de API do gateway. A entrada padrão do Google no cofre de credenciais usa o Vertex; endpoints Custom da Developer API são configurados separadamente. Nem uma chave do Google nem store=false no payload de inferência substituem essa configuração. Configure o armazenamento de requisições no projeto Google utilizado como uma etapa separada.
store=false significa retenção zero de dados?
A opção nativa store=false do Gemini controla o armazenamento de requisições da aplicação. A retenção de segurança do provedor, o cache e outros estados têm regras próprias. A flag, sozinha, não garante retenção zero de dados em todo o caminho da requisição.
Desativar o fallback garante que todas as requisições permaneçam no meu projeto?
A opção de fallback por falha no provedor cobre uma parte da decisão. Credenciais ausentes ou inelegíveis e cadeias explícitas de modelos exigem verificações separadas. Exija uma rejeição observável sempre que uma carga de trabalho restrita a um projeto não tiver uma credencial e um serviço aprovados disponíveis.