Hunyuan3D API
Hunyuan3D от Tencent — генерация 3D по изображению, тексту и наброску для визуализации и контентных процессов. Варианты V2 Base, Mini и Multi-View, а также конечные точки V3 Image-to-3D, Text-to-3D и Sketch-to-3D.
V2: v2-base и v2-mini — 3D по одному изображению; v2-multi-view — реконструкция по нескольким изображениям; v2.1 — масштабируемое создание ассетов. V3: image-to-3d (сверхвысокое разрешение по фото), text-to-3d (полностью текстурированные модели по промптам) и sketch-to-3d (от концепт-арта к сетке).
Обзор
О модели Hunyuan3D API
Что делает Hunyuan3D, какое место занимает в линейке моделей Tencent и почему её выбирают команды.
Hunyuan3D — модель генерации 3D-ассетов от Tencent, доступная через REST API WaveSpeedAI. Hunyuan3D от Tencent — генерация 3D по изображению, тексту и наброску для визуализации и контентных процессов. Варианты V2 Base, Mini и Multi-View, а также конечные точки V3 Image-to-3D, Text-to-3D и Sketch-to-3D.
V2: v2-base и v2-mini — 3D по одному изображению; v2-multi-view — реконструкция по нескольким изображениям; v2.1 — масштабируемое создание ассетов. V3: image-to-3d (сверхвысокое разрешение по фото), text-to-3d (полностью текстурированные модели по промптам) и sketch-to-3d (от концепт-арта к сетке).
Семейство Hunyuan3D в WaveSpeedAI включает 7 REST-эндпоинтов для сценариев: Image-To-3d, Text-To-3d. У каждого варианта свои цены, параметры и примеры результатов — выберите тот, что подходит под ваш тип входных данных и требования продакшена, или вызывайте несколько с одним API-ключом и собирайте многошаговые пайплайны.
Запускайте Hunyuan3D с тем же API-ключом, платёжным аккаунтом и лимитами, что и остальные 1000+ ИИ-моделей WaveSpeedAI. Без отдельной регистрации у вендора, без SDK для каждого провайдера, без разных лимитов у каждого поставщика — одна интеграция охватывает всё: от текста в изображение и текста в видео до синтеза аудио, 3D-генерации, апскейлинга и редактирования.
Эндпоинты
Все эндпоинты API Hunyuan3D
Сейчас в WaveSpeedAI доступно эндпоинтов Hunyuan3D: 7 — выберите вариант под ваш сценарий.
/filters:quality(82)/media/images/1789124787640423161_ZFOX7hqy.webp)
Hunyuan3d v3 Sketch To 3d
Transform your sketches into detailed 3D models with Tencent's Hunyuan3D V3. Convert hand-drawn sketches and concept art into high-quality 3D assets with textures, perfect for rapid prototyping and game development. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1789121202949516194_iYoyHQZ9.webp)
Hunyuan3d v3 Image To 3d
Transform your photos into ultra-high-resolution 3D models in seconds with Tencent's Hunyuan3D V3 Image to 3D. Film-quality geometry with PBR textures from single or multi-view images, ready for games, e-commerce, and 3D printing. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1789116903089615525_rhenxGPZ.webp)
Hunyuan3d v3 Text To 3d
Turn text prompts into detailed, fully-textured 3D models with Tencent's Hunyuan3D V3. Generate high-quality 3D assets with PBR materials from simple descriptions, ready for Unity, Unreal, and Blender. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1789124963421423807_NtCLU3dn.webp)
Hunyuan3d v2.1
Tencent Hunyuan3D v2.1 is a scalable 3D asset-creation system that advances state-of-the-art 3D generation for asset workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408111455_pe9fgusa.webp)
Hunyuan3d v2 Multi View
Hunyuan3D V2 Multi-View generates accurate 3D reconstructions from multiple images. Tencent-developed and available on WaveSpeedAI. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408111453_hu9t8kxy.webp)
Hunyuan3d v2 Mini
Hunyuan3D-V2-Mini is a Tencent image-to-3D generative model available on WaveSpeedAI. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408111447_w87sl0cm.webp)
Hunyuan3d v2 Base
Hunyuan3D-V2-Base is a state-of-the-art Image-to-3D model by Tencent that turns images into 3D assets for visualization and content. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Примеры
Hunyuan3D в деле
Реальные результаты, созданные через API Hunyuan3D. Наведите курсор на видео для предпросмотра, нажмите, чтобы открыть в полном размере.
Как использовать
Как использовать API Hunyuan3D
Четыре шага от регистрации до готовой генерации. Полные примеры на Python, Node.js и cURL — в разделе API ниже.
- 01
Получите API-ключ
Создайте аккаунт WaveSpeedAI и скопируйте API-ключ на панели управления. Новые аккаунты получают бесплатные стартовые кредиты — их хватит, чтобы несколько десятков раз запустить playground до начала списаний.
- 02
Отправьте предсказание
Отправьте входные данные в формате JSON методом POST на https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. Эндпоинт сразу возвращает id предсказания — генерация асинхронная, поэтому соединение не нужно держать открытым на время инференса.
- 03
Опрашивайте до завершения
Выполняйте GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. При статусе completed забирайте результат; при failed, cancelled, timeout или deleted остановитесь с ошибкой; при любом другом статусе продолжайте опрос.
- 04
Получите URL результата
Когда статус станет "completed", возьмите URL из data.outputs[0]. Он указывает на созданный файл в CDN WaveSpeedAI — изображение, видео, аудио или 3D-файл, в зависимости от вызванного варианта Hunyuan3D.
Сценарии применения
Что можно создать с Hunyuan3D
Типичные сценарии, для которых разработчики и авторы используют API Hunyuan3D.
3D-ассет по одному изображению
wavespeed-ai/hunyuan3d/v2-base — передовая модель Image-to-3D от Tencent, превращающая изображения в 3D-ассеты для визуализации и контента — конечная точка по умолчанию для создания сеток продуктов и персонажей.
Лёгкий вариант Mini
wavespeed-ai/hunyuan3d/v2-mini — компактная генеративная модель image-to-3D от Tencent — полезна для быстрых итераций, превью на мобильных и конвейеров, где детали сетки можно доработать позже.
Реконструкция по нескольким ракурсам
wavespeed-ai/hunyuan3d/v2-multi-view создаёт точные 3D-реконструкции по нескольким изображениям — передайте виды спереди, сбоку и сзади для более точной геометрии закрытых поверхностей.
v2.1 — масштабируемое создание ассетов
wavespeed-ai/hunyuan3d/v2.1 — масштабируемая система создания 3D-ассетов от Tencent, развивающая передовую 3D-генерацию — вариант для рабочих процессов с ассетами, требующих более высокой детализации.
V3 text-to-3D по промптам
wavespeed-ai/hunyuan3d-v3/text-to-3d превращает текстовые промпты в детализированные, полностью текстурированные 3D-модели — создавайте ассеты по описанию без исходного изображения.
V3 sketch-to-3D для концепт-арта
wavespeed-ai/hunyuan3d-v3/sketch-to-3d преобразует рисованные наброски и концепт-арт в детализированные 3D-модели — полезно на ранних этапах поиска дизайна.
Советы
Советы по написанию запросов для Hunyuan3D
Практические советы, как получать лучшие результаты от Hunyuan3D, — на основе приёмов, которые работают в продакшен-пайплайнах для моделей 3D.
- 01
Multi-view для закрытой геометрии
Когда у вас есть фото спереди, сбоку и сзади, используйте v2-multi-view — Base/Mini по одному изображению угадывают закрытые поверхности, а multi-view реконструирует их точно.
- 02
Mini для быстрых итераций
v2-mini — для быстрых черновых сеток при поиске концепции; когда направление геометрии зафиксировано, переключитесь на v2-base или v2.1.
- 03
Чистые, хорошо освещённые исходные изображения
Качество image-to-3D упирается в качество исходного фото. Равномерное освещение, минимум теней и чёткий силуэт объекта дают более чистые сетки.
- 04
Закладывайте PBR на последующих этапах
Hunyuan3D выдаёт сетки для визуализации — запланируйте текстурирование и проход PBR-материалов в вашем DCC-инструменте или движке рендеринга после генерации.
- 05
Фото продуктов на нейтральном фоне
Предметные фото для e-commerce на белом/нейтральном фоне дают самое чистое извлечение геометрии — пёстрый фон добавляет шум в реконструированную сетку.
Цены
Цены на API Hunyuan3D
Оплата — за каждый результат. Итоговая стоимость зависит от параметров, заданных в playground каждого варианта (разрешение, длительность, количество результатов, референсы).
| Эндпоинт | Тип | Цена от |
|---|---|---|
| wavespeed-ai/ | image-to-3d | $0.45 |
| wavespeed-ai/ | image-to-3d | $0.30 |
| wavespeed-ai/ | text-to-3d | $0.30 |
| wavespeed-ai/ | image-to-3d | $0.45 |
| wavespeed-ai/ | image-to-3d | $0.20 |
| wavespeed-ai/ | image-to-3d | $0.12 |
| wavespeed-ai/ | image-to-3d | $0.16 |
API
Вызов API Hunyuan3D
Получите API-ключ на wavespeed.ai/accesskey, затем отправьте предсказание через REST. Playground генерирует готовые к вставке примеры для любой комбинации входных данных.
POSThttps://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Сравнение
Hunyuan3D и альтернативы
Когда стоит выбрать Hunyuan3D, а не похожие модели в WaveSpeedAI.
Hunyuan3D и Tripo3D
Tripo3D предлагает быстрый image-to-3D с запеканием текстур. Hunyuan3D охватывает несколько уровней качества (Base, Mini, Multi-View, v2.1) из исследовательского стека Tencent — выбирайте по типу входных данных (один или несколько ракурсов) и требуемой детализации.
Hunyuan3D и Meshy
Meshy — веб-инструмент 3D-генерации. Hunyuan3D в WaveSpeedAI построен по принципу API-first — лучше для автоматизированных конвейеров, пакетной генерации ассетов и интеграции в SaaS без ручного шага в интерфейсе.
Hunyuan3D и Manual photogrammetry
Фотограмметрия требует десятков фотографий и долгой обработки. Hunyuan3D создаёт пригодную сетку по одному или нескольким изображениям за секунды — быстрее для прототипирования, менее точно для реконструкции уровня сканирования.
FAQ
Hunyuan3D API — часто задаваемые вопросы
Цены, лицензия, интеграция — частые вопросы о запуске Hunyuan3D в WaveSpeedAI.
Что такое API Hunyuan3D?
Hunyuan3D — модель 3D от Tencent, доступная как REST API в WaveSpeedAI. Hunyuan3D от Tencent — генерация 3D по изображению, тексту и наброску для визуализации и контентных процессов. Варианты V2 Base, Mini и Multi-View, а также конечные точки V3 Image-to-3D, Text-to-3D и Sketch-to-3D. Её можно вызывать программно или попробовать в playground по ссылке выше.
Как вызывать API Hunyuan3D?
Создайте аккаунт WaveSpeedAI, скопируйте API-ключ на странице /accesskey и отправьте POST на https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base с входными данными в JSON. Эндпоинт вернёт id предсказания. Опрашивайте эндпоинт результата примерно раз в 2 секунды, для долгих задач увеличивайте интервал и останавливайтесь на любом финальном статусе. Примеры для продакшена на Python / Node.js / cURL — выше.
Сколько стоит API Hunyuan3D?
Hunyuan3D стоит от $0.12 за запуск. Точная стоимость зависит от заданных параметров (разрешение, длительность, количество результатов, референсы). Предпросмотр стоимости рядом с кнопкой «Сгенерировать» в playground показывает точную цену для ваших текущих данных.
Какие варианты Hunyuan3D доступны?
В WaveSpeedAI доступно рабочих эндпоинтов Hunyuan3D: 7 — wavespeed-ai/hunyuan3d-v3/sketch-to-3d, wavespeed-ai/hunyuan3d-v3/image-to-3d, wavespeed-ai/hunyuan3d-v3/text-to-3d, wavespeed-ai/hunyuan3d/v2.1, wavespeed-ai/hunyuan3d/v2-multi-view, wavespeed-ai/hunyuan3d/v2-mini, wavespeed-ai/hunyuan3d/v2-base. У каждого варианта своя страница playground и свои цены.
Можно ли использовать результаты Hunyuan3D в коммерческих целях?
Права на коммерческое использование определяются лицензией модели Tencent. Большинство моделей Tencent разрешают коммерческое использование результатов; краткое описание лицензии смотрите на странице playground каждой модели, а условия платформы — в Условиях использования WaveSpeedAI.
Зачем использовать Hunyuan3D в WaveSpeedAI, а не напрямую?
Один API-ключ и один платёжный аккаунт для Hunyuan3D И для 1000+ других ИИ-моделей от разных провайдеров. Без настройки SDK для каждого вендора, без отдельных лимитов, без переписывания интеграционного кода под каждого поставщика. Цены, как правило, на уровне прямого API Tencent или ниже.
Разработчик
О Tencent
Команда, стоящая за Hunyuan3D и всей линейкой моделей Tencent в WaveSpeedAI.
Команда Hunyuan компании Tencent создаёт Hunyuan3D — семейство моделей image-to-3D, превращающих фотографии в 3D-сетки для визуализации, игровых ассетов и электронной коммерции. Варианты охватывают генерацию по одному изображению, лёгкий инференс Mini, реконструкцию по нескольким ракурсам и масштабируемую систему создания ассетов v2.1.
Начните создавать с Hunyuan3D в WaveSpeedAI
Бесплатные стартовые кредиты при регистрации. Один API-ключ для 1000+ ИИ-моделей от Tencent и всех остальных провайдеров.