Что такое API генерации 3D Neural4D?

Neural4D API позволяет разработчикам программно генерировать водонепроницаемые 3D-модели. Он работает на движке Direct3D-S2 и использует Spatial Sparse Attention (SSA) для высокопроизводительной генерации с разрешением до 2048³.

Как API выполняет генерацию сетки и текстур?

Процесс генерации разделен на два этапа: базовая сетка без текстур создается примерно за 90 секунд, затем отдельно генерируются PBR-карты текстур. Общее время создания полностью текстурированной модели составляет чуть более 2 минут.

Какие языки программирования и рабочие процессы поддерживаются?

API можно интегрировать с любой платформой через стандартные HTTP-запросы. Мы предоставляем руководства по интеграции для Python и JavaScript, чтобы упростить подключение к AI-агентам, автоматизированным рабочим процессам и кастомным графическим пайплайнам.

Как интегрировать API Neural4D в пользовательские рабочие процессы

Что такое API генерации 3D-моделей Neural4D?

API Neural4D предоставляет разработчикам программный доступ к движку Direct3D-S2 (NeurIPS 2025). Этот движок создаёт замкнутые меши непосредственно по текстовым или графическим запросам, минуя традиционные процессы полигонального моделирования. Основной алгоритм использует механизм пространственного разреженного внимания (SSA) для высокой геометрической точности, создавая чистые меши с преобладанием четырёхугольников с разрешением до 2048³ вокселей.

Как подключиться через REST API: пример на Python

API Neural4D — это независимый от языка REST-интерфейс, который можно интегрировать в любые автоматизированные приложения с помощью HTTP-запросов (Node.js, C#, Python и др.). Перед началом убедитесь, что вы получили API-ключ Neural4D. API разделяет генерацию базового меша и расчёт карт текстур. Создание базового меша занимает примерно 90 секунд. Узнайте, как реализовать это в API-генераторе 3D-моделей на Python или при интеграции универсального API преобразования текста в 3D. Ниже приведён пример интеграции на Python:

python

import requests
import time

API_KEY = "your_api_key_here"
GENERATE_URL = "https://alb.neural4d.com:3000/api/generateModelWithText"
RETRIEVE_URL = "https://alb.neural4d.com:3000/api/retrieveModel"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json;charset=utf-8"
}

# Generate a watertight mesh with clean topology
payload = {
    "prompt": "mechanical gear, industrial grade, quad-dominant",
    "modelCount": 1,
    "disablePbr": 0
}

response = requests.post(GENERATE_URL, json=payload, headers=headers)
data = response.json()
uuids = data.get("uuids", [])

if not uuids:
    print("Failed to start generation.")
else:
    target_uuid = uuids[0]
    print(f"Task created with UUID: {target_uuid}. Processing mesh generation...")
    
    # Polling for task status (Base mesh: ~90s, Textures: ~30s additional)
    while True:
        status_resp = requests.post(RETRIEVE_URL, json={"uuid": target_uuid}, headers=headers)
        result = status_resp.json()
        code_status = result.get("codeStatus")
        
        if code_status == 0:
            print(f"Generation successful. Download GLB at: {result.get('modelUrl')}")
            break
        elif code_status in [-1, -2, -3]:
            print(f"Generation failed. Status Code: {code_status}")
            break
            
        time.sleep(10)

Как расширить пайплайн для генерации изображений и видео?

Тот же Bearer-токен также открывает доступ к эндпоинтам генерации медиа. Задачи создания изображений и видео принимают текстовый запрос и до шести референсных изображений, отправляют от одной до четырёх задач за запрос и используют multipart/form-data для загрузки вместо application/json. Результат опрашивается через эндпоинт queryGenerationResult, который возвращает URL для скачивания, когда задача получает статус completed.

Эндпоинт	Назначение	Основные параметры
/api/createNormalPicture	Генерация изображений по текстовому запросу с необязательными референсными изображениями	prompt, images (до 6), modelKey (по умолчанию image-2), aspectRatio (1:1, 16:9, 9:16, 4:3, 3:4), jobNum (от 1 до 4)
/api/createNormalVideo	Генерация видео по текстовому запросу с необязательными референсными изображениями	prompt, images (до 6), aspectRatio (по умолчанию 16:9), duration (от 4 до 15 с, по умолчанию 5), resolution (480p, 720p, 1080p, по умолчанию 720p), jobNum (от 1 до 4)
/api/queryGenerationResult	Проверка результата задачи генерации изображения или видео по UUID	uuid; возвращает data.status (completed, queued, processing, failed), data.resultType (image, video), data.resultUrl

Опрашивайте queryGenerationResult, используя UUID, полученный от эндпоинта создания, пока data.status не станет равен completed, затем скачайте файл по адресу data.resultUrl. В отличие от генерации, этот запрос не расходует баллы.

Какие параметры запроса оптимизируют результаты генерации мешей и текстур?

Используйте параметры запроса ниже, чтобы настроить результаты генерации мешей и текстур. Для расширенных настроек и сведений об эндпоинтах обратитесь к официальной справке API generateModelWithText.

Параметр	Тип	Описание и диапазон
prompt	String	Описание 3D-модели. Указывайте геометрические особенности (например, замкнутый меш, преобладание четырёхугольников).
modelCount	Integer	Количество моделей, запланированных для генерации. Значение по умолчанию — 4.
disablePbr	Integer	Переключатель функции PBR. 0 = PBR включён, 1 = PBR выключен. Значение по умолчанию — 0.
onlyGenerateMesh	Boolean	Генерировать только базовый меш без PBR-текстур. Значение по умолчанию — false.
mesh_quality	String	Целевое качество сетки: standard, high или extra_high. Значение по умолчанию — high.
faceNum	Integer	Целевое количество граней. Для качества standard — от 100 000 до 500 000 (по умолчанию 500 000). Для high и extra_high — от 500 000 до 1 000 000 (по умолчанию 1 000 000).

Каким промышленным и разработческим процессам полезен API?

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

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

Схема рабочего процесса интеграции Neural4D API: поток запросов от Python-клиента к облачному движку Direct3D-S2 и возврат водонепроницаемых 3D-моделей

Нужна дополнительная помощь? Если у вас есть вопросы или возникли проблемы при интеграции, вы можете оставить отзыв онлайн на Neural4D Feedback или связаться с нашей технической командой по электронной почте support@neural4d.com.

Как интегрировать API Neural4D в пользовательские рабочие процессы

Что такое API генерации 3D-моделей Neural4D?

Как подключиться через REST API: пример на Python

Как расширить пайплайн для генерации изображений и видео?

Какие параметры запроса оптимизируют результаты генерации мешей и текстур?

Каким промышленным и разработческим процессам полезен API?

ПРОДУКТЫ

ФУНКЦИИ

КОМПАНИЯ

РЕСУРСЫ