Que sont ChatGPT et Gemini et comment fonctionnent-ils avec Neural4D ?

Ils peuvent rédiger du code à partir d’instructions en langage naturel. Fournissez-leur la documentation à jour de l’API de génération 3D à partir de texte de Neural4D pour les aider à rédiger un script qui crée un modèle, vérifie le résultat et télécharge le fichier. Vérifiez et testez le script avant de l’utiliser.

Comment rédiger le prompt idéal pour la génération 3D ?

Fournissez à l’IA la documentation à jour de l’API de génération 3D à partir de texte. Demandez-lui d’utiliser un jeton Bearer stocké dans une variable d’environnement, d’envoyer une requête de génération, de conserver l’UUID renvoyé, d’interroger le résultat, de gérer les erreurs et de télécharger le modèle depuis modelUrl.

Comment créer des applications 3D avec des outils d’IA et l’API Neural4D

1. Créer des automatisations et des applications avec des outils d’IA

Que sont ChatGPT et Gemini ? Ce sont des outils d’IA capables de rédiger et d’expliquer du code à partir d’instructions en langage naturel. Fournissez-leur la documentation de référence de l’API Neural4D Text-to-3D pour les aider à rédiger un script Python ou Node.js qui crée un modèle. Le guide de démarrage rapide de l’API explique l’authentification et le fonctionnement asynchrone des résultats. Examinez et testez tout code généré avant de l’utiliser.

Vous pouvez adapter ce processus à une application 3D personnalisée, à un bot Discord ou à un pipeline de contenu automatisé. Vérifiez que l’élément créé répond aux exigences de votre projet avant de l’utiliser dans un produit final.

Vous cherchez plutôt à développer une interface frontend ? Si vous préférez générer les modèles manuellement et utiliser Gemini pour rédiger le code d’affichage, par exemple avec Three.js, consultez notre guide pour créer des sites web 3D interactifs ou regardez le tutoriel vidéo ci-dessous :

Besoin d’une intégration directe du code ? Les développeurs qui souhaitent rédiger manuellement leurs propres scripts backend sans outils d’IA peuvent consulter notre guide consacré à l’intégration de l’API Neural4D dans des workflows personnalisés.

2. Comment préparer votre clé API Neural4D ?

Avant d’exécuter un script, vous avez besoin d’une clé API pour l’authentification Bearer. Pour découvrir la procédure en détail, consultez notre guide Comment obtenir et gérer votre clé API Neural4D.

Étape 1	Connectez-vous à Neural4D Studio.
Étape 2	Cliquez sur l’icône API en bas de la barre latérale gauche.
Étape 3	Cliquez sur Créer une clé API et saisissez un libellé pour la clé.
Étape 4	Cliquez sur Confirmer, puis conservez la clé en lieu sûr.

Ne communiquez jamais votre clé dans des conversations avec une IA, des dépôts publics ou du code côté client. Le script ci-dessous la lira depuis une variable d’environnement locale.

3. Comment demander à un outil d’IA de générer un script de création 3D ?

Fournissez à l’outil d’IA la documentation de référence actuelle de l’API ainsi que le processus de requête ci-dessous. Copiez cette invite telle quelle. Conservez votre véritable clé API sur votre ordinateur et ne la collez jamais dans la conversation.

prompt

Write a Python script using requests to generate one 3D model with the Neural4D API.
Follow the current documentation:
https://docs.neural4d.com/en/api-reference/text-to-3d/generate-model-from-text
https://docs.neural4d.com/en/api-reference/model-management/retrieve-model

1. Read the API key from the NEURAL4D_API_KEY environment variable. If it is missing, show a clear error. Never print or hard-code the key.
2. Build the Authorization header as Bearer plus the key read from NEURAL4D_API_KEY. Send POST https://alb.neural4d.com:3000/api/generateModelWithText with Content-Type: application/json. Use JSON: {"prompt": "A futuristic sci-fi helmet", "modelCount": 1}.
3. Check the HTTP response and API errors. Save the first UUID from the response's "uuids" array.
4. Poll POST https://alb.neural4d.com:3000/api/retrieveModel with JSON {"uuid": saved_uuid} and the same headers. Use a configurable interval and a maximum wait time.
5. In the retrieval response, "codeStatus" 1 means generating and 0 means complete. Handle -1 (invalid or expired token), -2 (unknown UUID), and -3 (generation failed) as errors.
6. When complete, download the asset from "modelUrl" and preserve its file extension when available. Do not assume the result is an OBJ file.
7. Add request timeouts, helpful error messages, and comments explaining how to run the script.

Vérifiez le script généré en vous référant aux pages de l’API indiquées avant de l’exécuter. Si vous avez besoin d’un fichier OBJ, utilisez l’API distincte de conversion de format des modèles après la génération. La conversion de format consomme des points.

4. Comment tester le script généré dans votre terminal ?

Une fois que ChatGPT ou Gemini vous a fourni le script Python, examinez-le, puis suivez ces étapes :

Enregistrez le code fourni dans un fichier nommé generate_3d.py sur votre ordinateur.
Ouvrez votre terminal, à savoir l’invite de commandes sous Windows ou Terminal sous macOS/Linux.
Installez la bibliothèque requests avec pip install requests.
Définissez localement NEURAL4D_API_KEY avec votre clé API. Dans PowerShell, utilisez $env:NEURAL4D_API_KEY="your_key". Dans l’invite de commandes, utilisez set NEURAL4D_API_KEY=your_key. Sous macOS ou Linux, utilisez export NEURAL4D_API_KEY="your_key".
Exécutez python generate_3d.py. Le script doit interroger la tâche jusqu’à ce qu’elle soit terminée, échoue ou atteigne le délai d’expiration configuré.
Vérifiez le modèle téléchargé et son format de fichier. La documentation actuelle de l’API indique un résultat GLB ; utilisez la conversion de format si votre projet nécessite un fichier OBJ ou un autre format.

5. Quelles sont les erreurs courantes avec les scripts générés par une IA ?

En cas d’échec d’une requête, vérifiez la réponse HTTP et le contenu de la réponse de l’API :

401 ou codeStatus -1	Vérifiez que `NEURAL4D_API_KEY` est défini et que la clé est valide. Générez une nouvelle clé si l’ancienne a expiré ou a été révoquée.
400 Bad Request	Vérifiez les noms et les valeurs des champs JSON en vous référant à la documentation actuelle de référence Text-to-3D.
402 ou 403	Vérifiez le solde de votre compte, vos autorisations et les éventuelles restrictions associées à votre compte.
429 Too Many Requests	Attendez avant de réessayer et réduisez la fréquence des requêtes envoyées par le script.
Réponse de modération	Une requête de génération peut renvoyer un message de modération au lieu d’un tableau `uuids`. Lisez ce message et modifiez le prompt.
codeStatus -2 ou -3	Vérifiez que l’UUID provient de la réponse de création. La valeur -2 signifie qu’il est introuvable ; -3 signifie que la génération a échoué.
ModuleNotFoundError	Installez la bibliothèque Python requests avec `pip install requests`.
Délai d’exécution du script dépassé	La tâche est peut-être encore en cours. Consultez le point de terminaison de suivi de la tâche ou réessayez en augmentant le délai d’attente maximal. Ne présumez pas d’une durée d’exécution fixe.

Comment créer des applications 3D avec des outils d’IA et l’API Neural4D

1. Créer des automatisations et des applications avec des outils d’IA

2. Comment préparer votre clé API Neural4D ?

3. Comment demander à un outil d’IA de générer un script de création 3D ?

4. Comment tester le script généré dans votre terminal ?

5. Quelles sont les erreurs courantes avec les scripts générés par une IA ?

PRODUITS

FONCTIONNALITÉS

ENTREPRISE

RESSOURCES