Em 29 de outubro de 2026, não existe uma API pública do Genie 4. O Genie 4 do Google DeepMind, anunciado em 27 de outubro de 2026, é uma prévia de pesquisa para testadores confiáveis, e o Google diz que ele está “chegando em breve” aos parceiros de acesso antecipado da API Gemini e do Google AI Studio, sem data, documentação, ID de modelo ou preço publicados até o momento.
Então você tem duas tarefas: entrar na fila e construir as partes de um app do Genie 4 que já funcionam na API Gemini pública.
Existe uma API do Genie 4?
Não. O Genie 4 do Google DeepMind não tem API pública, nem página de referência de API e nem ID de modelo na API Gemini em 29 de outubro de 2026. O Google nomeia os “parceiros de acesso antecipado da API Gemini e do Google AI Studio” como o próximo grupo depois dos testadores confiáveis, mas não publicou formulário de inscrição, data ou preço para essa via.
Veja o que está e o que não está registrado:
| Item | Status em 29 de out. de 2026 | Fonte |
|---|---|---|
| Data do anúncio | 27 de outubro de 2026 | Google DeepMind |
| Acesso atual | Prévia de pesquisa para testadores confiáveis | Google DeepMind |
| Próximo grupo de desenvolvedores | Parceiros de acesso antecipado da API Gemini e do Google AI Studio | Google DeepMind |
| Próximo grupo de consumidores | Assinantes do Google AI Ultra no Project Genie | Google DeepMind |
| Lista de espera pública | Um formulário, para o Genie 4 no Project Genie | Formulário da lista de espera |
| Página do Genie na documentação da API Gemini | Nenhuma (/gemini-api/docs/genie retorna 404) |
Verificado em 29 de out. de 2026 |
| Modelo Genie na página de modelos | Não listado | Página de modelos do Gemini |
| ID do modelo, preço, limites de taxa | Não anunciados | Nenhuma |
| Resolução, fps, duração da sessão | Não anunciados | Nenhuma |
| Marca d’água na saída | SynthID em todo vídeo e áudio | Google DeepMind |
Para o resumo dos recursos, leia nosso explicador do Google Genie 4. Este post se atém à API.
O que o Google disse sobre o acesso à API do Genie 4, palavra por palavra
O Google menciona o acesso de desenvolvedores duas vezes no anúncio. Logo no início:
“Começamos a disponibilizar o Genie 4 como uma prévia de pesquisa para testadores confiáveis, coletando feedback antes de lançá-lo para consumidores e desenvolvedores, começando pelos assinantes do Google AI Ultra no Project Genie e pelos parceiros de acesso antecipado da API Gemini e do Google AI Studio.”
E na seção “Próximos passos para o Genie 4”:
“O Genie 4 foi lançado como uma prévia de pesquisa para testadores confiáveis, e chegará em breve aos assinantes do Google AI Ultra no Project Genie e aos parceiros de acesso antecipado na API Gemini e no Google AI Studio.”
Leia com atenção: “parceiros de acesso antecipado” é um grupo selecionado, não um beta aberto; o único link anexado é a lista de espera do Project Genie para consumidores, e nada indica um trimestre nem diz “disponibilidade geral”.
O Google também lista seus próprios limites: os ambientes permanecem coerentes “em sessões curtas”, enquanto detalhes e a permanência de objetos “ainda podem mudar ou se desviar com o tempo”.
Como obter acesso antecipado ao Genie 4 hoje
Ainda não há inscrição para desenvolvedores, então estes passos preparam você para quando ela surgir:
- Entre na lista de espera do Genie 4. Clique em “Join the Genie 4 waitlist” no post do Google DeepMind. Isso abre o formulário da lista de espera do Google para o Project Genie. Não é um programa para desenvolvedores, mas é o único sinal que o Google pediu.
- Obtenha uma chave da API Gemini e uma conta de faturamento. Crie uma chave no Google AI Studio. Um projeto ativo na API Gemini é uma aposta razoável para se tornar parceiro, mas não é uma regra declarada.
- Acompanhe a documentação da API Gemini. Confira a página de modelos e as notas de versão na barra lateral da documentação.
- Construa sobre a Interactions API. O guia da Interactions API do Google diz que “todos os novos modelos, capacidades multimodais, ferramentas e recursos agênticos serão lançados na Interactions API”. O Genie 4 não é citado ali, mas, se ele chegar à API Gemini, essa é a via padrão declarada.
- Entregue algo com cara de modelo de mundo. Os testadores do Google vêm de indústrias criativas, jornalismo, educação, jogos e engenharia.
Para saber o custo do Project Genie, veja O Project Genie é gratuito?, e para modelos de mundo que você pode testar hoje, alternativas ao Project Genie.
O que você pode construir hoje com a API Gemini
O Genie 4 não é um modelo isolado. O Google descreve o Gemini 3.8 Flash como “um agente orientador no loop”: ele observa a cena, divide um objetivo em etapas, “revisa os frames que chegam para acompanhar o progresso e f que cada etapa foi bem-sucedida”, e adapta o plano quando o usuário interfere.
Essa metade supervisora já é pública agora. O gemini-3.8-flash está na API Gemini, com um nível gratuito e tarifas pagas de US$ 0,75 por 1 milhão de tokens de entrada e US$ 3,75 por 1 milhão de tokens de saída até 31 de dezembro de 2026, conforme a página de preços da API Gemini. Você pode apontá-lo para frames de qualquer fonte hoje (uma engine de jogos, um gravador de tela, uma captura do Genie 3) e trocar por frames do Genie 4 depois.
Veja um supervisor mínimo em Python, baseado nos formatos de requisição da documentação de compreensão de imagens do Google. Mantenha o nome do modelo em uma variável para poder trocá-lo no dia do lançamento:
import base64, json, os
from google import genai
MODEL = os.environ.get("SUPERVISOR_MODEL", "gemini-3.8-flash")
client = genai.Client() # reads GEMINI_API_KEY
PLAN = {"type": "object", "properties": {
"steps": {"type": "array", "items": {"type": "string"}}}, "required": ["steps"]}
VERDICT = {"type": "object", "properties": {
"done": {"type": "boolean"}, "reason": {"type": "string"}}, "required": ["done", "reason"]}
def frame(path):
with open(path, "rb") as f:
return {"type": "image", "mime_type": "image/png",
"data": base64.b64encode(f.read()).decode()}
def ask(text, image, schema, previous=None):
kwargs = dict(model=MODEL, input=[{"type": "text", "text": text}, image],
response_format={"type": "text", "mime_type": "application/json",
"schema": schema})
if previous:
kwargs["previous_interaction_id"] = previous
turn = client.interactions.create(**kwargs)
return turn.id, json.loads(turn.output_text)
goal = "The character walks to the red door and opens it."
turn_id, plan = ask(f"Goal: {goal}\nBreak it into short visual steps.",
frame("frame_000.png"), PLAN)
for i, step in enumerate(plan["steps"], start=1):
turn_id, verdict = ask(f"Step {i}: {step}\nDoes this frame show it done?",
frame(f"frame_{i:03d}.png"), VERDICT, previous=turn_id)
print(i, step, verdict)
if not verdict["done"]:
break # re-plan here, or send a steering prompt to your simulator
Dois detalhes sustentam o loop. O response_format com um esquema JSON mantém toda resposta legível por máquina, e o previous_interaction_id permite que o servidor mantenha o plano entre os turnos, para que você não reenvie o histórico. A Interactions API armazena as requisições por padrão; defina store=False se precisar de chamadas sem estado.
Não executamos isso com uma chave ativa, então teste primeiro com seus próprios frames.
Para um passo a passo mais amplo do modelo, veja como usar a API do Gemini 3.8 Flash.
Teste as requisições do supervisor com o Apidog CLI
Um supervisor que muda silenciosamente o formato do seu JSON quebra o seu loop. Delegue a verificação ao seu agente de programação e ao Apidog CLI:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Depois, dê um único prompt ao Claude Code, ao Codex ou ao Cursor:
In Apidog project <id>, create a test case for POST
https://generativelanguage.googleapis.com/v1beta/interactions with header
x-goog-api-key from the {{GEMINI_API_KEY}} environment variable. Send model
gemini-3.8-flash, a short goal, one base64 PNG frame and a response_format JSON
schema with "done" (boolean) and "reason" (string). Assert status 200 and that
output_text parses as JSON with both fields. Run it against the gemini
environment and summarize any failures.
O agente consulta o formato do payload em vez de adivinhá-lo, valida o arquivo, cria o caso e o executa:
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json
Vale a pena adicionar dois parâmetros do apidog run para um loop de visão. -n, --iteration-count <n> repete o caso para que você possa identificar vereditos instáveis, e -d, --iteration-data <path> alimenta um arquivo CSV ou JSON de frames e objetivos, um por iteração. Quando o ID do modelo Genie 4 for lançado, você altera uma única variável de ambiente e executa novamente.
Troque -r cli,json por -r junit e a mesma execução entra no CI. Nosso guia de CI/CD do Apidog CLI mostra o pipeline, e Apidog CLI no Claude Code cobre a configuração do agente. O plano gratuito do Apidog atende até 4 usuários.
O que observar quando a API do Genie 4 for lançada
O Google não descreveu a API. Estas perguntas determinam como você vai integrá-la:
| Pergunta | Por que importa | Conhecido em 29 de out. de 2026? |
|---|---|---|
| ID do modelo | Sua configuração e seus casos de teste dependem dele | Não |
| Transporte da saída | Mundos em tempo real podem precisar de streaming ou WebSockets, como a Live API do Gemini, em vez de uma única resposta | Não |
| Modelo de sessão | Sessões longas ou com estado mudam a forma como você armazena e retoma mundos | Não |
| Entradas | As demonstrações do Google mostram controles de teclado, condução por texto e uma imagem de referência como o primeiro frame; como isso se mape para os campos da API não foi publicado | Não |
| Unidade de preço | Por segundo, por frame, por sessão ou por token muda completamente o seu modelo de custos | Não |
| Limites de duração da sessão | O próprio Google diz que a coerência se mantém em sessões curtas | Não |
| Saída de áudio | O Genie 4 gera áudio nativamente; o formato de API para isso não foi publicado | Não |
| Marca d’água | O Google diz que todo vídeo e áudio do Genie 4 carrega SynthID | Sim, para o modelo |
Planeje para isso agora: mantenha o nome do modelo, a URL base e o cálculo de preços na configuração, coloque a fonte de frames atrás de uma única interface e registre em log cada frame e veredito, já que o Google diz que o desvio aumenta com a duração da sessão.
Se você vem do Genie 3, nossa visão geral do Google Genie 3 e como usar o Google Genie 3 cobrem o modelo anterior.
FAQ
Existe uma chave de API do Genie 4? Ainda não. Nenhum modelo Genie 4 aparece na API Gemini em 29 de outubro de 2026. Uma chave padrão da API Gemini do Google AI Studio funciona para o gemini-3.8-flash, o modelo que o Google usa como supervisor do Genie 4, mas ela não desbloqueia o Genie 4.
Como me torno um parceiro de acesso antecipado da API Gemini para o Genie 4? O Google não publicou um processo. Entre na lista de espera do Project Genie, mantenha um projeto ativo na API Gemini e acompanhe a página de modelos da API Gemini e as notas de versão para um anúncio.
Existe uma API do Project Genie? Não. O Project Genie é uma experiência para consumidores em labs.google/projectgenie. O Google lista a API Gemini e o Google AI Studio como a via para desenvolvedores do Genie 4.
Quanto vai custar a API do Genie 4? O Google não anunciou preços, nível gratuito nem unidade de cobrança. Trate qualquer valor que você veja antes de uma página de preços oficial como um chute.
Posso testar o Genie 4 no Google AI Studio hoje? Não, a menos que você seja um testador confiável. O Google diz que os parceiros de acesso antecipado do AI Studio vêm em seguida, sem data definida.