Como controlar o Blender com GPT-6 Astra no Codex

Você pode controlar o Blender com GPT-6 Astra no Codex sem conhecer todas as ferramentas de modelagem. Descreva o objeto desejado: o plugin oficial Computer Use permite que o agente veja o Blender e opere sua interface. Você ajusta a forma, confere o resultado e salva o projeto por etapas.

Escolha como acessar o modelo:

Sua situação	Como conectar
Conta e assinatura com acesso ao Codex e ao Astra	Entre na conta oficial e selecione GPT-6 Astra
Sem assinatura	Conecte uma API Key da BetterToken; não é necessário entrar em uma conta oficial do Codex

Nos dois casos, instale o mesmo Computer Use oficial pela seção Plugins. A API Key muda o acesso ao modelo e a cobrança das solicitações; a instalação do plugin continua igual.

Vamos da instalação a uma luminária de mesa editável e uma animação curta. Você precisa de um Mac ou computador Windows capaz de executar o Blender. O modelo recebe solicitações pela internet; o Blender e a renderização funcionam no seu computador.

Exemplo da análise oficial da OpenAI. É um projeto arquitetônico separado; aqui começaremos com uma luminária pequena.

1. Instale o aplicativo e configure o modelo no Codex

Acesse a página oficial de download do ChatGPT, escolha o aplicativo de desktop para seu sistema e instale. No aplicativo atual, o Codex fica no seletor de modos. Se você já tem o Codex App separado, atualize-o e use a seção Codex.

Com assinatura

1. Abra o aplicativo e escolha entrar pelo ChatGPT.
2. Entre na conta que possui a assinatura.
3. Mude para Codex.
4. Escolha GPT-6 Astra no seletor de modelo junto à mensagem. Se não aparecer, confira os modelos disponíveis na sua conta.

Essa opção não exige uma chave da BetterToken. Continue para a criação do projeto.

Sem assinatura: conecte uma API Key da BetterToken

Essa opção também funciona sem uma conta oficial do Codex. Você usa sua própria conta BetterToken e paga pelas solicitações ao modelo conforme o uso.

Crie uma API Key da BetterToken para usar GPT-6 Astra no Codex com o Blender.

Se o Codex já funciona com API Key

Basta trocar Base URL e API Key da conexão existente pelos dados da BetterToken. Não é necessário executar o instalador novamente.

1. Crie uma chave para o provedor GPT na BetterToken.
2. Abra as configurações atuais do provedor de API no Codex. Troque Base URL (base_url) por https://www.bettertoken.ai/v1 e a API Key pela sua chave BetterToken. Se a chave estiver em uma variável de ambiente, atualize seu valor.
3. Confirme o modelo gpt-6-astra. Se usava outro modelo, altere o identificador.
4. Salve, reinicie completamente o Codex e envie uma mensagem curta para testar.

Com a conexão funcionando, continue para o projeto e o Blender. Reutilize o Computer Use se já estiver instalado; caso contrário, siga as etapas abaixo.

Se esta é sua primeira conexão por API

1. Abra Workspace na BetterToken e crie uma API Key para o provedor GPT. Copie a chave para configurá-la no seu computador.
2. Na configuração da conexão da chave, escolha Codex e gpt-6-astra. Use o identificador completo, sem abreviar para astra.
3. Abra o guia da BetterToken para Codex, na seção Command-line setup. O instalador precisa do Node.js; se não estiver instalado, siga primeiro essa parte do guia.
4. Feche completamente o Codex. Abra Terminal no Mac ou PowerShell no Windows e execute o comando correspondente abaixo.
5. Quando o instalador pedir a API Key, cole-a localmente. Não a envie no chat com o agente. Aguarde a configuração e o teste de conexão.

macOS — Terminal:

curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" -o /tmp/install-codex-provider.sh
bash /tmp/install-codex-provider.sh --model gpt-6-astra

Windows — PowerShell:

iwr "https://www.bettertoken.ai/install-codex-provider.ps1" -OutFile "$env:TEMP\install-codex-provider.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1" -Model "gpt-6-astra"

O instalador configura o provedor BetterToken e a conexão pela Responses API, depois faz um teste curto do modelo. Esse teste também consome tokens de API. Ao terminar, reabra o aplicativo e selecione Codex. Essa conexão não exige login pelo ChatGPT.

Se a configuração falhar, confira primeiro a chave, o acesso ao modelo e o saldo para a chamada de API. Instalar Computer Use não corrige erros de conexão com o modelo.

2. Crie um projeto local

1. Crie uma pasta astra-blender no computador, por exemplo dentro de Documents.
2. No Codex, clique no + ao lado de Projects e adicione a pasta como projeto local. O nome pode variar por idioma e versão; escolha um projeto no seu computador.
3. Abra uma nova tarefa nele e confirme que Astra está selecionado.
4. Envie: “Responda com uma palavra: pronto”.

Uma resposta sem erro de conexão indica que pode continuar para o Blender. Com API, a chamada também deve aparecer no histórico de uso da BetterToken. Esse teste verifica o modelo; o acesso à janela do Blender será testado separadamente.

A pasta guardará o arquivo .blend, imagens e animação. Volte à mesma tarefa nas próximas alterações para manter as instruções anteriores disponíveis ao Codex.

3. Instale e abra o Blender

O Blender é gratuito e serve para modelagem 3D, materiais, animação e renderização. Baixe pela página oficial do Blender.

1. Escolha a versão para seu sistema. No Mac, verifique se o processador é Apple Silicon ou Intel.
2. No macOS, abra a imagem baixada e arraste o Blender para Applications. No Windows, execute o instalador e siga as etapas.
3. Abra o Blender. Você pode manter as configurações iniciais e criar um arquivo General.
4. Normalmente haverá um cubo no centro e Cube, Camera e Light na lista da cena à direita. Não os exclua ainda.
5. Em File → Save As, salve desk-lamp.blend na pasta astra-blender.

Para pedir ajuda ao Codex com a instalação, envie na tarefa do projeto:

Help me install Blender from https://www.blender.org/download/ for this computer.
Check whether Blender is already installed first. Use the official stable build.
Explain any installer or system-permission step I need to complete myself.
Open Blender and tell me which version is running.

A instalação está pronta quando a janela do Blender está aberta. Um link de download na resposta não basta. As instruções por sistema estão no manual do Blender.

4. Instale o Computer Use oficial

As etapas são iguais para assinatura e API Key da BetterToken:

1. Abra Plugins no aplicativo.
2. Procure Computer Use da OpenAI e clique em Install plugin.
3. Se aparecer Enable, ative-o.
4. No cartão, ative MCP server e Skill. O servidor fornece as ferramentas de controle; a Skill contém as instruções de uso.
5. Em Settings → Computer use, ative Any App se essa opção aparecer na sua versão. Permita acesso ao Blender quando solicitado.
6. No Mac, conceda Screen Recording e Accessibility nas configurações do sistema. Reinicie o aplicativo se solicitado.
7. Volte à tarefa do projeto. Se necessário, abra uma nova tarefa para carregar as ferramentas do plugin.

O guia oficial do Computer Use mostra onde ficam as opções. No Windows, mantenha o Blender visível na área de trabalho ativa e não bloqueie o computador: o agente usa o mouse e o teclado dessa sessão.

Agora teste o controle da interface:

Use the official Computer Use plugin to inspect the open Blender window.
Tell me the current file name and the objects visible in the scene list.
Through the Blender interface, rename Cube to Connection_Test.
Show the updated scene list, then stop. Do not create or delete objects.

Confira o Blender: o cubo deve permanecer no lugar, com o nome Connection_Test na lista. Se o Codex só descrever as ações, peça para executá-las pelo Computer Use. O teste confirma que ele vê e altera a janela correta.

5. Crie seu primeiro modelo

Comece com uma luminária de mesa de base redonda, haste e cúpula inclinada. É um objeto fácil de conferir. Na primeira etapa, peça o uso da interface para acompanhar as ações.

Use Computer Use to build a small desk lamp in the current Blender project.
Work through Blender's graphical interface for this first pass. Do not generate
the geometry with a Python script or command-line process.

Replace only the Connection_Test object from our connection check.
Create a round base, a vertical stem, a short angled arm, a conical shade,
and a bulb. Keep the parts as separate editable objects named Lamp_Base,
Lamp_Stem, Lamp_Arm, Lamp_Shade, and Lamp_Bulb.

Use simple proportions and place the lamp upright on a flat surface.
Set a camera that shows the entire lamp. Save desk-lamp.blend in this project.
Show a front view and a side view, then stop for my feedback.

Confira primeiro a silhueta: a base apoia na superfície, a haste se conecta à cúpula e a luminária inteira cabe no enquadramento. Selecione uma peça na lista. Se base e cúpula puderem ser selecionadas separadamente, o modelo continua editável.

Corrija um problema visível por vez: “alargue a base”, “encurte a haste” ou “incline a cúpula para a mesa”. Salve após cada alteração satisfatória para poder voltar à forma aprovada.

Geometria do projeto oficial da OpenAI. Essa visualização ajuda a verificar objetos e interseções sem depender de uma iluminação bonita. Ilustra o método, não o resultado do exercício da luminária.

6. Adicione materiais e iluminação

Quando a forma estiver boa, passe à aparência:

Continue with the existing desk lamp. Keep its geometry and object names.
Give the base and shade a muted blue painted-metal material, the stem a brushed
metal material, and the bulb a warm glow. Add soft studio lighting and a neutral
background. Do not add decorations or rebuild the lamp.

Render a 640x360 preview from the camera. Inspect the image, fix obvious floating
parts, intersections, or framing problems, and save preview-front.png and
desk-lamp.blend in this project. Stop after the preview for my feedback.

O agente pode sugerir a API Python do Blender, bpy, para operações repetitivas. Se quiser usar apenas a interface, reforce essa condição. Se preferir alterar a cena mais rápido, pode permitir código ou conectar o MCP oficial abaixo. Nos dois casos, peça para abrir e inspecionar visualmente o resultado.

Materiais e luz no exemplo oficial da OpenAI. Nesse projeto, Astra combinou bpy e inspeção de renders; a imagem não demonstra um processo feito só com o mouse.

Para continuar: conecte o MCP oficial do Blender

Computer Use controla a interface. MCP oferece ao Codex outro canal para o Blender em execução, permitindo ler a cena e realizar operações. É útil quando as ações manuais se acumulam; não é obrigatório no primeiro exercício.

1. Abra a página de MCP do Blender e as instruções oficiais de Setup.
2. Confira a versão: o projeto oficial atual exige Blender 5.1 ou posterior.
3. Na mesma tarefa, forneça o link de Setup e peça a instalação da extensão do Blender e do MCP server separado, seguida do registro do servidor no Codex. São duas partes da conexão.
4. Quando a extensão estiver pronta, abra Edit → Preferences → Add-ons → Install from Disk no Blender, escolha o ZIP e ative a extensão. O Codex pode ajudar com Computer Use.
5. Inicie o servidor de conexão nas configurações da extensão. Endereço e porta devem coincidir com os do MCP server; use os valores das instruções oficiais atuais.
6. Abra outra tarefa no mesmo projeto e peça para ler a lista de objetos via MCP. Compare Lamp_Base, Lamp_Shade e as demais peças com o Blender.

Não altere a cena até as listas coincidirem. Depois, use MCP para construir e Computer Use para inspecionar a janela e o render. Se a conexão cair, confira o estado atual da cena antes de criar peças novamente.

7. Faça uma animação curta

Salve primeiro o modelo estático aprovado. Para o primeiro vídeo, basta mover a câmera ao redor dele:

Use the existing lamp scene to create a 6-second camera orbit at 24 fps,
frames 1 through 144. Keep the lamp still and all parts editable.
Move the camera smoothly through a quarter-circle around the lamp, keeping the
whole object in frame. Do not change the materials or add new objects to the lamp.

Save a separate file named desk-lamp-animation.blend.
Render 640x360 preview images for frames 1, 72, and 144 as
orbit-001.png, orbit-072.png, and orbit-144.png.
Inspect those images and stop before rendering the full animation.

Abra as três imagens. A câmera não deve atravessar a luminária, cortar a cúpula nem mostrar um quadro vazio. Se estiver tudo certo, peça para renderizar os 144 quadros em uma pasta separada e montar desk-lamp-orbit.mp4. Mantenha 640×360 no primeiro vídeo; uma resolução maior aumenta o tempo de renderização local.

Se demorar, peça o progresso do render atual. Não inicie outro render da mesma cena antes de saber se o primeiro terminou.

Se algo não funcionar

Sintoma	O que conferir
Codex não responde, retorna 401 ou não encontra o modelo	Com API, confira chave, provedor GPT, gpt-6-astra e resultado da configuração; reinicie completamente
O modelo responde, mas faltam ferramentas Computer Use	Confira instalação e opções server e Skill; abra uma nova tarefa
Há ferramentas, mas a janela está inacessível	Permita Blender; no Mac confira Screen Recording e Accessibility, no Windows a área de trabalho ativa e desbloqueada
O agente descreve, mas não executa	Peça uma ação pequena via Computer Use e o estado após ela
MCP mostra outra cena	Confira o .blend aberto, a instância do Blender e endereço/porta da extensão
A chamada é interrompida ou expira	Peça primeiro a lista de objetos e arquivos salvos; retome da última etapa concluída
A imagem está ruim	Volte à forma e a um ângulo; corrija proporções, interseções e luz antes do render completo

Ao final, você terá desk-lamp.blend, um arquivo separado de animação, imagens para conferir e, após renderizar tudo, um vídeo. Reabra o .blend e altere uma peça por conta própria; depois continue com uma alteração específica para o Codex.