Comment contrôler Blender avec GPT-6 Astra dans Codex

Pour contrôler Blender avec GPT-6 Astra dans Codex, il n’est pas nécessaire de connaître tous les outils de modélisation. Décrivez l’objet souhaité : le plugin officiel Computer Use permet à l’agent de voir Blender et d’utiliser son interface. Vous affinez la forme, vérifiez le résultat et enregistrez le projet à chaque étape.

Choisissez votre mode d’accès au modèle :

Votre situation	Connexion
Compte et abonnement donnant accès à Codex et Astra	Connectez-vous à votre compte officiel et sélectionnez GPT-6 Astra
Sans abonnement	Utilisez une clé API BetterToken ; aucune connexion à un compte officiel Codex n’est nécessaire

Dans les deux cas, installez le même plugin officiel Computer Use depuis Plugins. La clé API modifie l’accès au modèle et la facturation des requêtes, mais pas l’installation du plugin.

Nous irons de l’installation à une lampe de bureau modifiable et une courte animation. Il vous faut un Mac ou un PC Windows capable d’exécuter Blender. Les requêtes au modèle passent par internet ; Blender et le rendu s’exécutent sur votre ordinateur.

Exemple tiré de la présentation officielle d’OpenAI. Il s’agit d’un projet architectural distinct ; nous commencerons par une petite lampe.

1. Installer l’application et configurer le modèle dans Codex

Ouvrez la page officielle de téléchargement de ChatGPT, choisissez l’application de bureau adaptée à votre système et installez-la. Dans l’application actuelle, Codex se trouve dans le sélecteur de modes. Si vous utilisez déjà l’application Codex App autonome, mettez-la à jour et utilisez sa section Codex.

Avec un abonnement

1. Lancez l’application et choisissez la connexion via ChatGPT.
2. Connectez-vous au compte disposant de l’abonnement.
3. Passez en mode Codex.
4. Sélectionnez GPT-6 Astra dans le choix de modèle près du message. Si le modèle est absent, vérifiez ceux auxquels votre compte a accès.

Aucune clé BetterToken supplémentaire n’est nécessaire. Passez à la création du projet.

Sans abonnement : utiliser une clé API BetterToken

Cette option fonctionne aussi sans compte officiel Codex. Vous utilisez votre propre compte BetterToken et payez les requêtes au modèle à l’usage.

Créez une clé API BetterToken pour utiliser GPT-6 Astra dans Codex avec Blender.

Si Codex fonctionne déjà avec une clé API

Il suffit de remplacer Base URL et API Key dans la connexion existante par les paramètres BetterToken. Inutile de relancer l’installateur.

1. Créez une clé pour le fournisseur GPT dans BetterToken.
2. Ouvrez les paramètres actuels du fournisseur API dans Codex. Remplacez Base URL (base_url) par https://www.bettertoken.ai/v1 et la clé par votre clé BetterToken. Si elle est stockée dans une variable d’environnement, actualisez sa valeur.
3. Vérifiez que le modèle est gpt-6-astra. Modifiez l’identifiant si vous utilisiez un autre modèle.
4. Enregistrez, redémarrez complètement Codex et envoyez un court message de test.

Une fois la connexion vérifiée, passez au projet et à Blender. Réutilisez Computer Use s’il est déjà installé ; sinon, suivez les étapes plus bas.

Pour une première connexion API

1. Ouvrez Workspace dans BetterToken et créez une clé API pour le fournisseur GPT. Copiez-la pour la configuration locale.
2. Dans la configuration de connexion de la clé, choisissez Codex et gpt-6-astra. Ne raccourcissez pas l’identifiant en astra.
3. Consultez le guide BetterToken pour Codex, section Command-line setup. L’installateur nécessite Node.js ; installez-le d’abord selon le guide s’il manque.
4. Quittez complètement Codex. Ouvrez Terminal sur Mac ou PowerShell sous Windows et exécutez la commande correspondante ci-dessous.
5. Collez votre clé localement lorsque l’installateur la demande. Ne l’envoyez pas dans le chat de l’agent. Attendez la fin de la configuration et du test.

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"

L’installateur configure le fournisseur BetterToken et la connexion via Responses API, puis effectue un court test du modèle. Ce test consomme lui aussi des tokens API. Rouvrez ensuite l’application et choisissez Codex. Ce mode de connexion ne nécessite pas de connexion ChatGPT.

En cas d’échec, vérifiez d’abord la clé, l’accès au modèle et le solde disponible pour l’appel API. Installer Computer Use ne résout pas une erreur de connexion au modèle.

2. Créer un projet local

1. Créez un dossier astra-blender sur votre ordinateur, par exemple dans Documents.
2. Dans Codex, cliquez sur + à côté de Projects et ajoutez ce dossier comme projet local. Le libellé peut varier selon la langue et la version ; il faut un projet sur votre ordinateur.
3. Ouvrez une nouvelle tâche dans ce projet et vérifiez qu’Astra est sélectionné.
4. Envoyez : « Réponds en un mot : prêt ».

Une réponse sans erreur de connexion permet de poursuivre avec Blender. Avec l’API, l’appel doit également apparaître dans l’historique d’utilisation BetterToken. Cela teste le modèle ; l’accès à la fenêtre Blender sera vérifié séparément.

Le dossier contiendra le fichier .blend, les images et l’animation. Revenez à cette même tâche pour les modifications suivantes afin que Codex retrouve vos instructions.

3. Installer et ouvrir Blender

Blender est un logiciel gratuit de modélisation 3D, de matériaux, d’animation et de rendu. Téléchargez-le sur la page officielle de Blender.

1. Choisissez la version adaptée à votre système. Sur Mac, distinguez Apple Silicon et Intel.
2. Sur macOS, ouvrez l’image téléchargée et glissez Blender dans Applications. Sous Windows, lancez l’installateur et suivez les étapes.
3. Lancez Blender. Vous pouvez conserver les réglages initiaux et créer un fichier General.
4. Un cube apparaît généralement au centre, avec Cube, Camera et Light dans la liste de scène à droite. Ne les supprimez pas encore.
5. Via File → Save As, enregistrez desk-lamp.blend dans astra-blender.

Pour demander l’aide de Codex à l’installation, envoyez dans le projet :

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.

L’installation est terminée lorsque la fenêtre Blender est ouverte. Un simple lien de téléchargement dans la réponse ne suffit pas. Les instructions par système figurent dans le manuel Blender.

4. Installer Computer Use officiel

Les étapes sont identiques avec un abonnement ou une clé API BetterToken :

1. Ouvrez Plugins dans l’application.
2. Cherchez Computer Use d’OpenAI et cliquez sur Install plugin.
3. Si Enable s’affiche, activez le plugin.
4. Dans sa fiche, activez MCP server et Skill : le serveur fournit les outils de contrôle, la Skill leurs instructions d’utilisation.
5. Dans Settings → Computer use, activez Any App si ce commutateur est présent. Autorisez l’accès à Blender lorsqu’il est demandé.
6. Sur Mac, accordez Screen Recording et Accessibility dans les réglages système. Redémarrez l’application si nécessaire.
7. Revenez à la tâche du projet. Au besoin, ouvrez une nouvelle tâche pour charger les outils du plugin.

Le guide officiel Computer Use indique où se trouvent les réglages. Sous Windows, gardez Blender visible sur le bureau actif et ne verrouillez pas l’ordinateur : l’agent utilise la souris et le clavier de cette session.

Testez maintenant le contrôle de l’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.

Regardez Blender : le cube doit rester en place et s’appeler Connection_Test dans la liste. Si Codex décrit seulement les actions, demandez leur exécution avec Computer Use. Ce test vérifie qu’il voit et modifie la bonne fenêtre.

5. Créer le premier modèle

Commencez par une lampe de bureau facile à vérifier : base ronde, pied et abat-jour incliné. Pour ce premier passage, demandez de travailler dans l’interface afin de suivre les actions.

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.

Vérifiez d’abord la silhouette : la base repose sur la surface, le pied rejoint l’abat-jour et la lampe entière entre dans le cadre. Sélectionnez une pièce dans la liste. Si la base et l’abat-jour sont sélectionnables séparément, le modèle reste modifiable.

Corrigez un défaut visible à la fois : « élargis la base », « raccourcis le pied », « incline l’abat-jour vers le bureau ». Enregistrez après chaque modification satisfaisante pour pouvoir revenir à la forme validée.

Géométrie du projet officiel d’OpenAI. Cette vue aide à vérifier les objets et leurs intersections indépendamment d’un bel éclairage. Elle illustre la méthode, pas le résultat de l’exercice de la lampe.

6. Ajouter matériaux et éclairage

Une fois la forme satisfaisante, travaillez l’apparence :

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.

L’agent peut proposer l’API Python de Blender, bpy, pour les opérations répétitives. Si vous voulez rester dans l’interface, rappelez cette contrainte. Pour modifier la scène plus vite, vous pouvez autoriser le code ou ajouter le MCP officiel ci-dessous. Dans les deux cas, demandez d’ouvrir et d’inspecter visuellement le résultat.

Matériaux et lumière de l’exemple officiel d’OpenAI. Astra y combinait bpy et inspection des rendus ; l’image ne montre pas un travail réalisé exclusivement à la souris.

Pour aller plus loin : connecter le MCP officiel de Blender

Computer Use contrôle l’interface. MCP offre à Codex une connexion distincte au Blender en cours d’exécution pour lire la scène et effectuer des opérations. Ajoutez-le lorsque les manipulations deviennent nombreuses ; il n’est pas requis pour le premier exercice.

1. Ouvrez la page MCP de Blender, puis les instructions officielles Setup.
2. Vérifiez la version : le projet officiel actuel nécessite Blender 5.1 ou ultérieur.
3. Dans la même tâche, donnez le lien Setup à Codex et demandez d’installer l’extension Blender et le MCP server séparé, puis d’enregistrer le serveur dans Codex. Ce sont les deux composants de la connexion.
4. Quand l’extension est prête, ouvrez Edit → Preferences → Add-ons → Install from Disk dans Blender, choisissez son ZIP et activez-la. Codex peut vous accompagner avec Computer Use.
5. Démarrez le serveur de connexion dans les réglages de l’extension. Son adresse et son port doivent correspondre à ceux du MCP server ; utilisez les valeurs du guide officiel actuel.
6. Ouvrez une nouvelle tâche dans le même projet et demandez de lire la liste d’objets via MCP. Comparez Lamp_Base, Lamp_Shade et les autres pièces avec Blender.

Ne modifiez rien tant que les listes ne correspondent pas. Ensuite, confiez la construction à MCP et l’inspection de la fenêtre et du rendu à Computer Use. En cas de déconnexion, vérifiez l’état de la scène avant de recréer des pièces.

7. Réaliser une courte animation

Enregistrez d’abord le modèle statique réussi. Pour un premier clip, un mouvement de caméra autour de lui suffit :

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.

Ouvrez les trois images. La caméra ne doit ni traverser la lampe, ni couper l’abat-jour, ni montrer un cadre vide. Si tout convient, demandez le rendu des 144 images dans un dossier séparé et leur assemblage en desk-lamp-orbit.mp4. Gardez 640×360 pour ce premier clip ; une résolution supérieure allonge le rendu local.

Si le rendu est lent, demandez son avancement. N’en lancez pas un second pour la même scène avant de savoir si le premier est terminé.

En cas de problème

Symptôme	Vérification
Codex ne répond pas, renvoie 401 ou ne trouve pas le modèle	Avec l’API, vérifiez clé, fournisseur GPT, gpt-6-astra et configuration ; redémarrez complètement
Le modèle répond mais les outils Computer Use manquent	Vérifiez l’installation, server et Skill ; ouvrez une nouvelle tâche
Les outils existent mais la fenêtre est inaccessible	Autorisez Blender ; sur Mac vérifiez Screen Recording et Accessibility, sous Windows le bureau actif et déverrouillé
L’agent décrit sans agir	Demandez une petite action avec Computer Use et l’état obtenu
MCP affiche une autre scène	Vérifiez le .blend ouvert, l’instance Blender et l’adresse/port de l’extension
Un appel est interrompu ou expire	Demandez d’abord les objets et fichiers enregistrés ; reprenez à la dernière étape terminée
L’image est mauvaise	Revenez à la forme et à un angle ; corrigez proportions, intersections et lumière avant le rendu complet

Vous devez obtenir desk-lamp.blend, un fichier d’animation distinct, des images de contrôle et, après le rendu complet, une vidéo. Rouvrez le .blend et modifiez vous-même une pièce, puis poursuivez avec une modification précise à demander à Codex.