ChatGPT と Gemini とは？Neural4D とどう連携する？

ChatGPT と Gemini は、自然言語の指示からコードの草案を作成できます。Neural4D の最新のテキストから3Dモデルを生成する API リファレンスを渡すと、モデルの作成、結果の確認、アセットのダウンロードを行うスクリプトの作成に役立ちます。使用前にスクリプトを確認し、テストしてください。

3D生成に最適なプロンプトを書くには？

最新のテキストから3Dモデルを生成する API リファレンスを AI に渡してください。環境変数から Bearer トークンを取得し、生成リクエストを送信し、返された UUID を保持し、結果を照会し、エラーを処理し、modelUrl からモデルをダウンロードするよう指示してください。

AIツールとNeural4D APIで3Dアプリを構築する方法

1. AIツールで自動化とアプリを構築する

ChatGPTとGeminiとは？ 自然言語の指示からコードを作成・説明できるAIツールです。現在のNeural4D Text-to-3D APIリファレンスを渡すと、モデルを作成するPythonまたはNode.jsスクリプトの作成に役立ちます。APIクイックスタートでは、認証と非同期の結果取得フローについて説明しています。生成されたコードは、使用する前に確認してテストしてください。

このワークフローは、カスタム3Dアプリケーション、Discordボット、自動コンテンツパイプラインにも応用できます。完成した製品で使用する前に、生成されたアセットがプロジェクトの要件を満たしているか確認してください。

フロントエンド開発をお探しですか？ モデルを手動で生成し、Geminiに表示用コード（Three.jsなど）を書かせたい場合は、インタラクティブな3Dウェブサイトの構築ガイドをご覧いただくか、以下の動画チュートリアルをご視聴ください。

コードを直接統合する必要がありますか？ AIツールを使わずに独自のバックエンドスクリプトを手動で作成したい開発者は、Neural4D APIをカスタムワークフローに統合する方法の専用ガイドをご覧ください。

2. Neural4D APIキーを準備する方法

スクリプトを実行する前に、Bearer認証用のAPIキーが必要です。詳しい手順については、Neural4D APIキーの取得と管理方法に関するガイドをご覧ください。

ステップ1	Neural4D Studioにログインします。
ステップ2	左サイドバー下部にあるAPIアイコンをクリックします。
ステップ3	APIキーを作成をクリックし、キーのラベルを入力します。
ステップ4	確認をクリックし、キーを安全に保管します。

APIキーをAIチャット、公開リポジトリ、クライアント側のコードに記載しないでください。以下のスクリプトは、ローカルの環境変数からキーを読み込みます。

3. 3D生成スクリプトをAIツールに指示する方法

現在のAPIリファレンスと、以下のリクエストフローをAIツールに渡してください。このプロンプトは記載どおりにコピーします。実際のAPIキーは自分のコンピューターに保管し、チャットには絶対に貼り付けないでください。

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.

実行する前に、生成されたスクリプトをリンク先のAPIページと照合して確認してください。OBJファイルが必要な場合は、生成後に別のモデル形式変換APIを使用します。形式変換にはポイントが消費されます。

4. 生成されたスクリプトをターミナルでテストする方法

ChatGPTまたはGeminiからPythonスクリプトが提供されたら、内容を確認してから次の手順に従ってください。

提供されたコードを、コンピューター上でgenerate_3d.pyという名前のファイルに保存します。
ターミナルを開きます（Windowsではコマンドプロンプト、macOS/Linuxではターミナル）。
pip install requestsでrequestsライブラリをインストールします。
APIキーをローカルのNEURAL4D_API_KEYに設定します。PowerShellでは$env:NEURAL4D_API_KEY="your_key"を使用します。コマンドプロンプトではset NEURAL4D_API_KEY=your_keyを使用します。macOSまたはLinuxではexport NEURAL4D_API_KEY="your_key"を使用します。
python generate_3d.pyを実行します。スクリプトは、ジョブが完了するか、失敗するか、設定されたタイムアウトに達するまでジョブの状態を確認します。
ダウンロードしたモデルとファイル形式を確認します。現在のAPIドキュメントではGLBの結果が示されています。プロジェクトでOBJまたは別の形式が必要な場合は、形式変換を使用してください。

5. AIが生成したスクリプトを使用する際によくあるエラー

リクエストが失敗した場合は、HTTPレスポンスとAPIレスポンスの本文を確認してください。

401またはcodeStatus -1	`NEURAL4D_API_KEY`が設定されており、キーが有効であることを確認してください。古いキーの有効期限が切れている場合や、無効化されている場合は、新しいキーを生成してください。
400 Bad Request	JSONのフィールド名と値を、現在のText-to-3Dリファレンスと照合して確認してください。
402または403	アカウント残高、権限、アカウントに関する制限を確認してください。
429 Too Many Requests	再試行までしばらく待ち、スクリプトからリクエストを送信する頻度を下げてください。
モデレーション応答	生成リクエストでは、`uuids`配列の代わりにモデレーションメッセージが返されることがあります。メッセージを確認し、プロンプトを修正してください。
codeStatus が -2 または -3	UUID が作成リクエストの応答から取得したものか確認してください。-2 は見つからなかったことを、-3 は生成に失敗したことを意味します。
ModuleNotFoundError	`pip install requests`で Python の requests ライブラリをインストールしてください。
スクリプトのタイムアウト	タスクがまだ実行中の可能性があります。ジョブの進捗確認用エンドポイントで確認するか、最大待機時間を長くして再試行してください。完了までの時間が一定だとは考えないでください。