yandex

Hunyuan3D v2 API

starstarstarstarstar

5/5

Hunyuan3D v2 — это флагманская модель генерации 3D, разработанная для задач, где особенно важны точность, аккуратность форм и структурная симметрия.

ID для подключения по API : hunyuan-3d

Средняя скорость генерации ~ 25.41 сек
Дата выхода: 15/04/2025

3D

Генерация моделей

По одному изображению

Премиальная

Запустить через API
SoTA

Премиальная

Запустить через API
SoTA

Выберите язык:

Как работать с Hunyuan3D v2 через API?

Получение API ключа

Для начала получите ваш API ключ в личном кабинете, если ещё не сделали этого.

Это ваш API-ключ с помощью, которого вы можете генерировать. Не сообщайте его никому.

Запрос на выполнение задачи

Теперь необходимо создать задачу на генерацию. Результат вы можете получать по-разному, можно по системе Long-Pooling, либо вы можете задать callback_url и мы отправим вам результат по готовности. Подробнее с тем, как использовать эти способы можете ознакомиться в документации. В данном примере мы рассмотрим способ с получением результата на callback_url.

В этом запросе указаны лишь обязательные параметры, если вам необходимы дополнительные параметры, то можете ознакомится с ними здесь

Пример ответа

Получение результата

На указанный в первом запросе callback_url придёт следующий ответ.

Ознакомиться с другими способами получения результата можете в документации

Параметры для генерации

callback_urlurl

Это URL, на который будет отправлен ответ от нейросети.

input_image_urlurl_or_file

Обязательно

Входное изображение.

num_inference_stepsinteger

Количество шагов диффузии.

Значение по умолчанию : 50

guidance_scalenumeric

Масштаб управления.

Значение по умолчанию : 7.5

octree_resolutioninteger

Разрешение октодерева.

Значение по умолчанию : 256

textured_meshboolean

Покраска текстур.

Значение по умолчанию : false

modelstring

Версия нейросети.

Значение по умолчанию : base