Что такое ChatGPT и Gemini и как они работают с Neural4D?

Они могут писать черновой код по инструкциям на обычном языке. Передайте им актуальную документацию API Neural4D для генерации 3D-моделей по тексту, чтобы получить скрипт, который создаёт модель, проверяет результат и скачивает файл. Перед использованием проверьте и протестируйте скрипт.

Как составить идеальный запрос для генерации 3D-модели?

Передайте ИИ актуальную документацию API для генерации 3D-моделей по тексту. Попросите его брать Bearer-токен из переменной окружения, отправлять запрос на генерацию, сохранять полученный UUID, запрашивать результат, обрабатывать ошибки и скачивать модель по адресу modelUrl.

Как создавать 3D-приложения с ИИ и API Neural4D

1. Создание автоматизаций и приложений с помощью ИИ

Что такое ChatGPT и Gemini? Это ИИ-инструменты, которые могут писать и объяснять код по инструкциям на обычном языке. Передайте им актуальную документацию API Neural4D для генерации 3D-моделей по тексту, чтобы они помогли написать скрипт на Python или Node.js для создания модели. В кратком руководстве по API описаны аутентификация и порядок получения результата асинхронной задачи. Проверяйте и тестируйте сгенерированный код перед использованием.

Этот подход можно адаптировать для собственного 3D-приложения, Discord-бота или автоматизированного процесса создания контента. Прежде чем использовать полученный 3D-ресурс в готовом продукте, проверьте, соответствует ли он требованиям вашего проекта.

Интересует разработка интерфейса? Если вы предпочитаете создавать модели вручную, а Gemini использовать для написания кода отображения, например на Three.js, прочитайте наше руководство по созданию интерактивных 3D-сайтов или посмотрите видеоурок ниже:

Нужна прямая интеграция через код? Если вы хотите писать серверные скрипты самостоятельно, без ИИ-инструментов, читайте отдельное руководство по интеграции API Neural4D в собственные рабочие процессы.

2. Как подготовить API-ключ Neural4D?

Для запуска скрипта нужен API-ключ для Bearer-аутентификации. Подробные инструкции есть в нашем руководстве по получению и управлению API-ключом Neural4D.

Шаг 1	Войдите в Neural4D Studio.
Шаг 2	Нажмите значок API внизу левой боковой панели.
Шаг 3	Нажмите Create API Key и введите название ключа.
Шаг 4	Нажмите Confirm и сохраните ключ в безопасном месте.

Не передавайте ключ в чаты с ИИ, не публикуйте его в открытых репозиториях и не добавляйте в клиентский код. Приведённый ниже скрипт прочитает его из локальной переменной окружения.

3. Как составить запрос к ИИ для создания скрипта генерации 3D-моделей?

Передайте ИИ-инструменту актуальную документацию 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.
Установите библиотеку requests с помощью команды pip install requests.
Локально задайте NEURAL4D_API_KEY, указав свой API-ключ. В PowerShell используйте $env:NEURAL4D_API_KEY="your_key", в командной строке Windows — set NEURAL4D_API_KEY=your_key, а в macOS или Linux — export NEURAL4D_API_KEY="your_key".
Запустите python generate_3d.py. Скрипт должен проверять состояние задачи, пока она не завершится, не закончится ошибкой или не истечёт заданное время ожидания.
Проверьте загруженную модель и формат файла. Согласно актуальной документации API, результат предоставляется в формате GLB. Если проекту нужен OBJ или другой формат, воспользуйтесь конвертацией.

5. Какие ошибки часто встречаются в скриптах, созданных ИИ?

Если запрос завершился ошибкой, проверьте HTTP-ответ и тело ответа API:

401 или codeStatus -1	Проверьте, задана ли переменная `NEURAL4D_API_KEY` и действителен ли ключ. Если срок действия старого ключа истёк или он был отозван, создайте новый.
400 Bad Request	Сверьте имена и значения полей JSON с актуальной документацией по генерации 3D-моделей из текста.
402 или 403	Проверьте баланс аккаунта, права доступа и возможные ограничения аккаунта.
429 Too Many Requests	Подождите перед повторной попыткой и сократите частоту запросов скрипта.
Ответ системы модерации	Вместо массива `uuids` запрос на генерацию может вернуть сообщение системы модерации. Прочитайте его и измените запрос.
codeStatus -2 или -3	Убедитесь, что UUID получен из ответа на запрос создания модели. Значение -2 означает, что результат не найден; -3 — что генерация завершилась ошибкой.
ModuleNotFoundError	Установите библиотеку Python requests с помощью `pip install requests`.
Истекло время ожидания скрипта	Задача может всё ещё выполняться. Проверьте статус через эндпоинт отслеживания задачи или повторите попытку, увеличив максимальное время ожидания. Не рассчитывайте на фиксированное время выполнения.

Как создавать 3D-приложения с ИИ и API Neural4D

1. Создание автоматизаций и приложений с помощью ИИ

2. Как подготовить API-ключ Neural4D?

3. Как составить запрос к ИИ для создания скрипта генерации 3D-моделей?

4. Как проверить сгенерированный скрипт в терминале?

5. Какие ошибки часто встречаются в скриптах, созданных ИИ?

ПРОДУКТЫ

ФУНКЦИИ

КОМПАНИЯ

РЕСУРСЫ