ChatGPT와 Gemini란 무엇이며 Neural4D와 어떻게 연동되나요?

자연어 지시를 바탕으로 코드를 작성할 수 있습니다. 현재 Neural4D 텍스트-3D API 레퍼런스를 제공하면 모델을 생성하고, 결과를 확인하고, 에셋을 다운로드하는 스크립트 작성을 도와줍니다. 스크립트를 사용하기 전에 검토하고 테스트하세요.

3D 생성을 위한 완벽한 프롬프트 작성 방법

AI에 최신 텍스트-3D API 레퍼런스를 제공하세요. 환경 변수에서 Bearer 토큰을 사용하고, 생성 요청을 제출하고, 반환된 UUID를 저장하고, 결과를 조회하고, 오류를 처리하고, modelUrl에서 모델을 다운로드하도록 요청하세요.

AI 도구와 Neural4D API로 3D 앱 만드는 방법

1. AI 도구로 자동화 워크플로와 앱 만들기

ChatGPT와 Gemini란? 자연어 지시를 바탕으로 코드를 작성하고 설명할 수 있는 AI 도구입니다. 최신 Neural4D 텍스트-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단계	Create API Key를 클릭하고 키의 라벨을 입력합니다.
4단계	Confirm을 클릭한 다음 키를 안전하게 보관합니다.

API 키를 AI 채팅, 공개 저장소 또는 클라이언트 측 코드에 노출하지 마세요. 아래 스크립트는 로컬 환경 변수에서 키를 읽습니다.

3. AI 도구에 3D 생성 스크립트를 요청하는 방법

AI 도구에 최신 API 레퍼런스와 아래 요청 흐름을 제공하세요. 프롬프트는 작성된 그대로 복사하세요. 실제 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 라이브러리를 설치합니다.
로컬에서 NEURAL4D_API_KEY을 API 키로 설정합니다. 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 필드 이름과 값을 최신 텍스트-3D API 레퍼런스와 대조해 확인하세요.
402 또는 403	계정 잔액, 권한 및 계정 제한 사항을 확인하세요.
429 Too Many Requests	다시 시도하기 전에 잠시 기다리고, 스크립트가 요청을 보내는 빈도를 줄이세요.
검토 응답	생성 요청은 `uuids` 배열 대신 검토 메시지를 반환할 수 있습니다. 메시지를 읽고 프롬프트를 수정하세요.
codeStatus -2 또는 -3	UUID가 생성 응답에서 반환된 값인지 확인하세요. -2는 찾을 수 없다는 의미이고, -3은 생성에 실패했다는 의미입니다.
ModuleNotFoundError	`pip install requests`을 사용해 Python requests 라이브러리를 설치하세요.
스크립트 시간 초과	작업이 아직 실행 중일 수 있습니다. 작업 진행 상황 엔드포인트를 확인하거나 최대 대기 시간을 늘려 다시 시도하세요. 완료 시간을 고정된 값으로 가정하지 마세요.