Was sind ChatGPT und Gemini? Das sind KI-Tools, die anhand natürlichsprachlicher Anweisungen Code entwerfen und erklären können. Geben Sie ihnen die aktuelle Referenz zur Neural4D Text-to-3D API, damit sie ein Python- oder Node.js-Skript zum Erstellen eines Modells entwerfen können. Der API-Schnellstart erklärt die Authentifizierung und den asynchronen Ablauf bis zum Ergebnis. Prüfen und testen Sie generierten Code vor der Verwendung.
Sie können diesen Ablauf für eine eigene 3D-Anwendung, einen Discord-Bot oder eine automatisierte Content-Pipeline anpassen. Prüfen Sie vor der Verwendung in einem fertigen Produkt, ob das erstellte Asset die Anforderungen Ihres Projekts erfüllt.
Interessieren Sie sich eher für Frontend-Entwicklung? Wenn Sie Modelle lieber manuell erstellen und Gemini den Code für die Darstellung schreiben lassen möchten, etwa mit Three.js, lesen Sie unseren Leitfaden zum Erstellen interaktiver 3D-Websites oder sehen Sie sich das Video-Tutorial unten an:
Möchten Sie die API direkt in Ihren Code integrieren? Wenn Sie Backend-Skripte ohne KI-Tools selbst schreiben möchten, lesen Sie unseren Leitfaden Neural4D API in eigene Workflows integrieren.
Bevor Sie ein Skript ausführen, benötigen Sie einen API-Schlüssel für die Bearer-Authentifizierung. Eine ausführliche Anleitung finden Sie in unserem Leitfaden Neural4D API-Schlüssel erstellen und verwalten.
| Schritt 1 | Melden Sie sich bei Neural4D Studio an. |
| Schritt 2 | Klicken Sie unten in der linken Seitenleiste auf das Symbol API. |
| Schritt 3 | Klicken Sie auf Create API Key und geben Sie eine Bezeichnung für den Schlüssel ein. |
| Schritt 4 | Klicken Sie auf Confirm und bewahren Sie den Schlüssel anschließend sicher auf. |
Geben Sie Ihren Schlüssel nicht in KI-Chats, öffentlichen Repositories oder clientseitigem Code preis. Das folgende Skript liest ihn aus einer lokalen Umgebungsvariable.
Geben Sie dem KI-Tool die aktuelle API-Referenz und den unten beschriebenen Ablauf der Anfragen. Kopieren Sie diesen Prompt unverändert. Behalten Sie Ihren echten API-Schlüssel auf Ihrem Computer und fügen Sie ihn niemals in den Chat ein.
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.Vergleichen Sie das generierte Skript vor der Ausführung mit den verlinkten API-Seiten. Wenn Sie eine OBJ-Datei benötigen, verwenden Sie nach der Generierung die separate API zur Konvertierung von Modellformaten. Die Formatkonvertierung verbraucht Punkte.
Sobald ChatGPT oder Gemini das Python-Skript erstellt hat, prüfen Sie es und gehen Sie dann wie folgt vor:
pip install requests.NEURAL4D_API_KEY lokal auf Ihren API-Schlüssel. Verwenden Sie in PowerShell $env:NEURAL4D_API_KEY="your_key", in der Eingabeaufforderung set NEURAL4D_API_KEY=your_key und unter macOS oder Linux export NEURAL4D_API_KEY="your_key".
python generate_3d.py aus. Das Skript sollte den Auftragsstatus abfragen, bis der Auftrag abgeschlossen ist, fehlschlägt oder das konfigurierte Zeitlimit erreicht.Wenn eine Anfrage fehlschlägt, prüfen Sie die HTTP-Antwort und den Inhalt der API-Antwort:
| 401 oder codeStatus -1 | Prüfen Sie, ob NEURAL4D_API_KEY gesetzt und der Schlüssel gültig ist. Erstellen Sie einen neuen Schlüssel, wenn der alte abgelaufen oder widerrufen wurde. |
| 400 Bad Request | Vergleichen Sie die Namen und Werte der JSON-Felder mit der aktuellen Text-to-3D-Referenz. |
| 402 oder 403 | Prüfen Sie Ihr Kontoguthaben, Ihre Berechtigungen und mögliche Kontoeinschränkungen. |
| 429 Too Many Requests | Warten Sie vor einem erneuten Versuch und reduzieren Sie, wie häufig das Skript Anfragen sendet. |
| Moderationsantwort | Eine Generierungsanfrage kann statt eines uuids-Arrays eine Moderationsmeldung zurückgeben. Lesen Sie die Meldung und passen Sie den Prompt an. |
| codeStatus -2 oder -3 | Bestätigen Sie, dass die UUID aus der Create-Antwort stammt. Der Wert -2 bedeutet, dass sie nicht gefunden wurde; -3 bedeutet, dass die Generierung fehlgeschlagen ist. |
| ModuleNotFoundError | Installieren Sie die Python-Bibliothek requests mit pip install requests.
|
| Timeout des Skripts | Die Aufgabe wird möglicherweise noch ausgeführt. Prüfen Sie den Endpunkt für den Aufgabenfortschritt oder versuchen Sie es erneut mit einer längeren maximalen Wartezeit. Gehen Sie nicht von einer festen Fertigstellungszeit aus. |
Benötigen Sie Hilfe? Support kontaktieren.
Mehr erfahren: Warum Ihr nächstes Projekt eine Image-to-3D-API benötigt.