Comment piloter Blender avec GPT-6 Astra dans Codex

Pour piloter Blender via Codex avec GPT-6 Astra, il n’est pas nécessaire de maîtriser tous les outils de modélisation 3D. Décrivez simplement le résultat attendu, et Codex sélectionnera une approche adaptée parmi celles disponibles : manipuler l’interface grâce au plugin officiel Computer Use, exécuter des scripts Blender Python (bpy) ou lancer des commandes Blender en arrière-plan. Vous n’avez pas à déterminer quel outil l’agent doit employer à chaque étape. Il vous suffit d’examiner les résultats intermédiaires et d’enregistrer votre projet à chaque étape clé.

Choisissez l’un des deux modes de connexion au modèle :

Votre situation	Comment vous connecter
Vous avez un compte et un abonnement donnant accès à Codex et Astra	Connectez-vous à votre compte officiel et sélectionnez GPT-6 Astra
Vous n’avez pas d’abonnement	Connectez une clé BetterToken API Key ; aucune connexion à un compte officiel Codex n’est requise

Dans les deux cas, installez le même plugin officiel Computer Use depuis la section Plugins. La clé API modifie uniquement le mode d’accès au modèle et la facturation des requêtes ; la procédure d’installation du plugin reste strictement identique.

Voici le déroulement complet, de l’installation des outils jusqu’à l’obtention d’une lampe de bureau éditable et d’une animation en orbite à 360 degrés. Vous aurez besoin d’un ordinateur Mac ou Windows capable de faire tourner Blender. Le modèle reçoit ses instructions via Internet, tandis que Blender et le rendu s’exécutent localement sur votre machine.

Dans la présentation officielle d’OpenAI, Astra conçoit une scène architecturale plus complexe. Ce guide s’appuie sur un projet compact de lampe de bureau, réalisé dans l’environnement décrit ci-dessous.

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

Rendez-vous sur la page officielle de téléchargement de ChatGPT, téléchargez l’application de bureau correspondant à votre système d’exploitation et installez-la. Dans l’application actuelle, Codex se trouve dans le sélecteur de mode. Si vous disposez déjà d’une application Codex autonome, mettez-la à jour et utilisez cette même section Codex.

Si vous avez un abonnement

1. Lancez l’application et choisissez de vous connecter avec ChatGPT.
2. Connectez-vous au compte sur lequel votre abonnement est actif.
3. Basculez sur Codex.
4. Dans le sélecteur de modèle situé à côté du champ de saisie, repérez GPT-6 Astra. S’il n’apparaît pas, vérifiez les modèles accessibles avec votre compte.

Aucune clé BetterToken distincte n’est requise pour cette méthode. Passez directement à la création du projet.

Si vous n’avez pas d’abonnement : connectez une clé BetterToken API Key

Cette solution fonctionne également sans compte Codex officiel. Vous utilisez votre compte BetterToken, et les requêtes adressées au modèle sont facturées selon votre consommation.

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

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

Dans une connexion API déjà active, il suffit de remplacer le Base URL et l’API Key par vos identifiants BetterToken. Il est inutile de réexécuter le script d’installation.

1. Dans BetterToken, créez une clé pour le fournisseur GPT.
2. Ouvrez les paramètres actuels du fournisseur d’API de Codex. Remplacez le Base URL (base_url) par https://www.bettertoken.ai/v1, et remplacez la clé API actuelle par votre clé BetterToken. Si la clé est conservée dans une variable d’environnement, mettez sa valeur à jour.
3. Assurez-vous que le modèle sélectionné est bien gpt-6-astra. Si un autre modèle était configuré précédemment, mettez à jour son identifiant.
4. Enregistrez les réglages, redémarrez complètement Codex et envoyez un message court pour valider la connexion.

Une fois le test réussi, poursuivez vers la configuration du projet et de Blender. Si Computer Use est déjà en place, vous pouvez continuer à vous en servir ; sinon, installez-le en suivant les étapes détaillées plus bas.

Si vous configurez une connexion API pour la première fois

1. Accédez à votre Workspace sur BetterToken et créez une clé API Key pour le fournisseur GPT. Copiez cette clé pour la renseigner sur votre ordinateur.
2. Dans la configuration de liaison de la clé, sélectionnez Codex et le modèle gpt-6-astra. L’identifiant complet est indispensable : ne le réduisez pas à astra.
3. Consultez le guide BetterToken pour Codex à la section Command-line setup. Le programme d’installation requiert Node.js ; si ce dernier n’est pas encore présent, installez-le d’abord en suivant les instructions de configuration.
4. Fermez entièrement Codex. Ouvrez le Terminal sur macOS ou PowerShell sous Windows, puis lancez la commande adaptée à votre système ci-dessous.
5. Lorsque l’installeur vous invite à saisir votre API Key, collez votre clé localement. Ne la transmettez pas dans la fenêtre de discussion avec l’agent. Patientez pendant la configuration et la validation automatique de la connexion.

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"

Le script d’installation configure le fournisseur BetterToken, active la liaison via la Responses API et soumet une requête rapide de vérification du modèle. Notez que ce test consomme lui aussi des jetons API. Une fois l’opération terminée, rouvrez l’application et accédez à Codex. L’authentification via ChatGPT n’est pas nécessaire dans cette configuration.

Si l’installation échoue, résolvez le problème à la source : contrôlez votre clé, vérifiez l’accès au modèle et assurez-vous que votre compte dispose des fonds nécessaires pour les requêtes API. L’installation de Computer Use ne corrigera pas un défaut de connexion au modèle.

2. Créer un projet local

1. Créez un dossier astra-blender sur votre disque — par exemple dans votre répertoire Documents.
2. Dans Codex, cliquez sur « + » à côté de Projects et ajoutez ce répertoire en tant que projet local. L’intitulé de ce bouton peut différer selon la langue et la version de l’application ; choisissez l’option permettant de déclarer un projet situé sur votre machine.
3. Démarrez une nouvelle tâche au sein de ce projet et vérifiez qu’Astra est bien sélectionné.
4. Envoyez un court message de contrôle : « Réponds en un seul mot : prêt ».

Si vous recevez une réponse sans message d’erreur, vous pouvez passer à l’étape suivante avec Blender. Dans le cas d’une connexion par API, l’appel doit aussi apparaître dans l’historique de consommation de votre compte BetterToken. Cela confirme la communication avec le modèle ; l’accès à la fenêtre de Blender sera validé séparément.

Ce dossier centralisera votre fichier .blend, vos rendus d’images et vos animations. Pour les requêtes suivantes, revenez dans cette même tâche afin que Codex conserve la mémoire de vos instructions antérieures.

3. Installer et ouvrir Blender

Blender est une suite logicielle gratuite pour la création 3D, intégrant modélisation, gestion des matériaux, animation et rendu. Vous pouvez la récupérer sur la page officielle de téléchargement de Blender.

1. Choisissez la version adaptée à votre système d’exploitation. Sur Mac, sélectionnez l’architecture appropriée : Apple Silicon ou Intel.
2. Sur macOS, ouvrez l’image disque téléchargée et faites glisser Blender dans Applications. Sous Windows, lancez le fichier d’installation et laissez-vous guider par les étapes.
3. Démarrez Blender. Lors de la première ouverture, gardez les options standards et créez un nouveau fichier General.
4. Au centre de l’espace de travail apparaît le cube initial, tandis que l’outliner sur la droite liste Cube, Camera et Light. Conservez-les pour l’instant.
5. Choisissez File → Save As, naviguez dans votre dossier astra-blender et enregistrez la scène sous le nom de desk-lamp.blend.

Si vous souhaitez déléguer l’installation à Codex, transmettez ce prompt au sein du projet créé :

Aide-moi à installer Blender depuis https://www.blender.org/download/ sur cet ordinateur.
Vérifie d'abord si Blender est déjà installé. Utilise la version stable officielle.
Explique les étapes de l'installateur ou les autorisations système que je dois valider moi-même.
Lance Blender et indique quelle version est en cours d'exécution.

L’installation est terminée une fois que la fenêtre de Blender est active à l’écran. Un simple lien de téléchargement fourni par Codex ne constitue pas une installation finalisée. Les directives officielles pour chaque système sont recensées dans le manuel de Blender.

4. Installer le plugin officiel Computer Use

Les étapes suivantes s’appliquent de manière identique avec un abonnement ou avec un BetterToken API Key :

1. Dans l’application, dirigez-vous vers l’onglet Plugins.
2. Recherchez Computer Use fourni par OpenAI et cliquez sur Install plugin.
3. Si le libellé devient Enable à l’issue de l’installation, enclenchez le plugin.
4. Dans les paramètres du plugin, activez son MCP server ainsi que son Skill — le serveur expose les actions de manipulation, et le Skill contient les instructions d’exécution.
5. Rendez-vous dans Settings → Computer use et activez la gestion d’applications Any App si cette case est disponible dans votre version. Accordez l’accès à Blender dès que l’application en fait la demande.
6. Sur Mac, autorisez les accès Screen Recording et Accessibility demandés au niveau des Réglages Système. Redémarrez l’application si macOS l’exige.
7. Revenez à votre tâche de projet. Si nécessaire, ouvrez une tâche vierge pour assurer le chargement des nouveaux outils du plugin.

La documentation officielle de Computer Use présente la disposition exacte de ces rubriques. Sous Windows, veillez à garder Blender visible sur un bureau actif sans verrouiller votre session : l’agent interagit en direct avec la souris et le clavier de cet environnement.

Testez à présent le pilotage de l’interface graphique :

Utilise le plugin officiel Computer Use pour examiner la fenêtre ouverte de Blender.
Indique-moi le nom du fichier actuel et les objets visibles dans la liste de la scène.
Depuis l'interface de Blender, renomme Cube en Connection_Test.
Affiche la liste mise à jour de la scène, puis arrête-toi. Ne crée et ne supprime aucun objet.

Observez Blender : le cube doit demeurer en place et son intitulé dans l’outliner doit être remplacé par Connection_Test. Si Codex décrit l’opération sans l’exécuter réellement, demandez-lui fermement d’accomplir l’action via Computer Use. Cette vérification rapide confirme que l’agent détecte la bonne fenêtre et peut la manipuler.

5. Créer votre premier modèle

Débutez avec un modèle dont la conformité est simple à contrôler : une lampe de bureau composée d’un socle circulaire, d’un pied, d’un bras incliné et d’un abat-jour. Exposez l’objectif global à l’agent en lui accordant la liberté de sélectionner le moyen d’action le plus stable.

Crée une petite lampe de bureau dans le projet Blender actuel. Si nécessaire,
tu peux utiliser Computer Use, Blender Python (bpy) ou des commandes
Blender en arrière-plan. Choisis l'outil disponible le plus fiable et ne pars
pas du principe que Blender MCP est installé.

Remplace uniquement l'objet Connection_Test issu de notre test de connexion.
Crée une base circulaire posée sur une surface plane à Z=0, un pied vertical,
un bras court incliné, un abat-jour conique avec une épaisseur de paroi
et une ampoule intérieure. Conserve les éléments sous forme d'objets distincts
et éditables nommés Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb et Ground.

Vérifie le résultat réel au niveau de l'alignement, des proportions et de la jonction
des pièces. Configure une caméra montrant la lampe dans son intégralité,
enregistre desk-lamp.blend dans ce projet et présente une vue de face
ainsi qu'une vue en perspective avant de t'arrêter pour recueillir mes retours.

Déroulement de l’exécution réelle

Ce cas réel a été produit sur macOS au moyen de l’application de bureau ChatGPT version 26.908.40834, avec Blender 5.2.1 LTS et le modèle GPT-6 Astra High. En premier lieu, Computer Use a renommé le cube en Connection_Test. Codex a ensuite rédigé des scripts bpy et les a exécutés via l’interpréteur Python fourni avec Blender. Il n’a pas été nécessaire de configurer un environnement Python dédié, d’initialiser un venv ni d’arbitrer manuellement chaque outil.

La saisie de commandes par la console interactive de Blender s’étant montrée instable, Codex s’est tourné vers le CLI de Blender en tâche de fond pour raccorder Lamp_Arm à Lamp_Shade et préparer les rendus. L’agent a ensuite réaffiché le fichier .blend dans la fenêtre principale de Blender pour contrôler visuellement le travail accompli.

La scène regroupe bien les objets indépendants Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb et Ground. La base du socle a été validée au contact de Z=0, l’abat-jour possède son épaisseur de paroi et l’ampoule est logée à l’intérieur.

Contrôlez ces éléments dans votre projet : le socle repose bien sur la surface, le pied s’ajuste à l’abat-jour, la lampe s’inscrit pleinement dans le cadre de la caméra et chaque partie reste sélectionnable à part. Procédez à une correction à la fois et enregistrez le fichier après chaque étape concluante.

6. Ajouter les matériaux et l’éclairage

Lorsque la forme générale convient, définissez le traitement de surface et la mise en lumière :

Poursuis le travail sur la lampe de bureau existante dans desk-lamp.blend.
Conserve sa géométrie et les noms de ses objets. Attribue une finition en émail
vert foncé à Lamp_Base et Lamp_Shade, un laiton brossé à Lamp_Stem et Lamp_Arm,
ainsi qu'une lueur chaude à Lamp_Bulb. Ajoute un matériau neutre pour Ground
et configure un éclairage studio trois points.

Utilise Cycles pour générer un aperçu net depuis la caméra. Examine l'image
pour détecter d'éventuelles pièces flottantes, des intersections, des défauts
de cadrage ou des reflets anormaux, puis enregistre l'aperçu et desk-lamp.blend.

Lors de l’essai documenté, le socle et l’abat-jour ont été habillés d’un émail vert foncé, la tige et le bras d’un laiton brossé, tandis que l’ampoule a reçu une émission lumineuse chaude. Codex a disposé un éclairage studio trois points et effectué le rendu dans Cycles. L’image finale est présentée en ouverture de cet article.

Pour aller plus loin : connecter le Blender MCP officiel

Computer Use permet d’interagir avec l’interface visuelle. De son côté, MCP offre à Codex une passerelle directe vers l’instance active de Blender afin d’analyser la structure de la scène et d’ordonner des modifications. Dans le déroulement présenté ci-dessus, Blender MCP n’a pas été requis ni installé : Codex a suffi à la tâche en combinant Computer Use, le moteur Python et le CLI de Blender. MCP constitue une option intéressante pour vos projets ultérieurs.

1. Consultez la page MCP sur le site de Blender puis accédez à la documentation officielle Setup.
2. Contrôlez votre version de Blender : la version officielle requiert 5.1 ou une version plus récente.
3. Dans la même session Codex, transmettez l’adresse du Setup en lui demandant d’installer l’extension Blender et le serveur MCP autonome, puis de déclarer ce serveur dans Codex. Ce sont les deux éléments nécessaires à la passerelle.
4. Une fois l’extension prête, rendez-vous dans Blender sous Edit → Preferences → Add-ons → Install from Disk, chargez l’archive ZIP puis validez l’activation. Codex peut vous guider dans cette manipulation grâce à Computer Use.
5. Dans les paramètres de l’extension, démarrez le serveur local. L’extension et le serveur MCP doivent impérativement concorder sur l’adresse d’hôte et le port ; reprenez les valeurs recommandées par la documentation officielle à jour.
6. Initiez une nouvelle tâche au sein du même projet Codex et demandez-lui d’extraire la liste des éléments par MCP. Comparez les dénominations Lamp_Base, Lamp_Shade et des autres composants avec celles affichées dans Blender.

Ne commencez aucune altération de la scène avant d’avoir vérifié l’exacte concordance de cette liste. Vous pourrez dès lors confier l’édition géométrique à MCP tout en réservant Computer Use au contrôle visuel des fenêtres et des rendus. En cas de perte de synchronisation, faites toujours le point sur l’état courant de la scène pour éviter toute création d’objets en double.

7. Réaliser une courte animation

Une fois la modélisation statique finalisée et sauvegardée, chargez Codex de paramétrer une animation circulaire à 360 degrés. Cette rotation peut être intégrée au sein du même fichier desk-lamp.blend :

Dans la scène desk-lamp.blend existante, crée un travelling circulaire de caméra
à 360 degrés sur 5 secondes à 24 fps. Positionne les images clés à la frame 1
(0 degré) et à la frame 121 (360 degrés), puis effectue le rendu des frames 1
à 120 afin que la boucle ne répète pas le point final. Utilise Cycles en 1280x720
avec 32 samples. Laisse la lampe immobile et l'ensemble des éléments éditables.

Génère d'abord les images de test 1, 41 et 81. Après confirmation, rends les
120 images PNG dans le dossier renders/ et encode une vidéo H.264 MP4 de 5 secondes
nommée desk-lamp-orbit.mp4. Enregistre la scène dans desk-lamp.blend.

Durant l’exécution du projet, Codex a produit en premier lieu les vues de contrôle pour les images 1, 41 et 81. Cycles, configuré avec 32 samples, a par la suite calculé les 120 fichiers PNG en 1280×720 dans le dossier renders/. La frame 121 correspondait à l’angle de 360° mais est restée hors de la séquence exportée, ce qui évite la duplication de l’image de départ.

L’exécutable FFmpeg du système n’a pas pu être lancé en raison de l’absence du fichier libvpx.11.dylib. Après avoir inspecté les fonctionnalités offertes par Blender 5.2.1, Codex a utilisé l’encodeur vidéo H.264 propre à Blender plutôt que d’intervenir sur les dépendances système. Avant l’encodage, il s’est assuré que l’intégralité des 120 fichiers PNG étaient présents et non vides, puis a exporté la vidéo H.264 MP4 paramétrée pour 120 images à 24 fps en 1280×720. Une fois le fichier généré, ouvrez-le afin de vérifier que la lecture s’effectue correctement sur ses cinq secondes.

Si le calcul des images prend trop de temps, demandez à Codex d’indiquer l’état d’avancement du rendu actif. Ne lancez jamais un second calcul sur la même scène sans vous être assuré que le premier est achevé.

Résolution des problèmes

Ce que vous constatez	Ce qu’il faut vérifier
Codex ne répond pas, renvoie 401 ou ne trouve pas le modèle	En cas de connexion API, vérifiez votre clé, le fournisseur GPT, gpt-6-astra et le compte-rendu de configuration ; redémarrez entièrement l’application
Le modèle répond, mais les outils Computer Use sont absents	Vérifiez l’installation du plugin, les commutateurs du serveur et du Skill ; ouvrez une nouvelle tâche
Les outils sont présents, mais la fenêtre est inaccessible	Autorisez l’accès à Blender ; sur Mac, vérifiez Screen Recording et Accessibility, sous Windows, assurez-vous que le bureau actif n’est pas verrouillé
L’agent décrit les étapes mais ne modifie rien	Demandez-lui explicitement d’exécuter une action ciblée via Computer Use et de montrer l’état de la scène après coup
MCP est connecté, mais affiche une autre scène	Vérifiez le fichier .blend ouvert, l’instance active de Blender ainsi que l’adresse et le port de l’extension
L’appel a été interrompu ou un timeout est survenu	Demandez d’abord la liste des objets et des fichiers enregistrés ; reprenez à partir de la dernière étape validée
Le FFmpeg du système refuse de se lancer	Dans ce projet, Codex a eu recours à l’encodeur H.264 intégré de Blender ; c’est une solution de contournement fiable si votre version de Blender gère ce format
L’image ne donne pas satisfaction	Revenez aux formes de base et à un angle de caméra unique ; ajustez les proportions, les intersections et l’éclairage avant de relancer un rendu complet

À la fin de cet atelier, vous devez disposer du fichier desk-lamp.blend, des images intermédiaires de validation, de 120 fichiers PNG dans le répertoire renders/ ainsi que de la vidéo desk-lamp-orbit.mp4. Ouvrez de nouveau le fichier .blend et soumettez à Codex une modification précise afin de vérifier que chaque pièce reste modifiable de façon indépendante.