Что такое Hunyuan3D 2.0?

Краткое определение: Hunyuan3D 2.0(*Hunyuan3D-2*) — это двухэтапная крупномасштабная генеративная система от Tencent для создания высокодетализированных текстурированных 3D-ассетов из мультимодальных входных данных (текст, 1–4 изображения, эскизы). Система разделяет генерацию формы (Hunyuan3D-DiT / ShapeVAE) и синтез текстур (Hunyuan3D-Paint), а также включает производственный UI/платформу (Hunyuan3D-Studio).

Основные возможности

Мультимодальные входные данные: Text-to-3D, image-to-3D (1–4 ракурса), sketch-to-3D. На глобальном сайте и в документации эти режимы указаны явно.
Двухэтапный конвейер:
1. Генерация формы — Hunyuan3D-DiT (latent diffusion / flow-matching на латентных представлениях ShapeVAE) создает базовую сетку.
2. Синтез текстур — Hunyuan3D-Paint генерирует многовидовые изображения с учетом геометрии; результаты затем запекаются в текстурные карты высокого разрешения.
Форматы вывода и интеграция: Экспортирует распространенные 3D-форматы (OBJ, GLB) и предназначена для интеграции с Unity, Unreal, Blender и стандартными производственными конвейерами. Enterprise API поддерживает генерацию PBR-материалов и варианты топологии (треугольники/квады).
Производственные функции: Умная топология (оптимизация сетки), стилизация low-poly, запекание текстур и поддержка анимации в студии (скелетный скиннинг через GNN для простого ретаргетинга в Hunyuan3D-Studio).

Производительность в бенчмарках (опубликованные метрики)

Из технического отчета / оценки Hunyuan3D 2.0 (репрезентативные метрики из таблицы 4 статьи; чем выше CLIP-score, тем лучше; чем ниже метрики CMMD / FID, тем лучше):

Model	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (baseline с открытым исходным кодом)	3.591	54.639	289.287	0.787
Closed-source Model 1	3.600	55.866	305.922	0.779
Closed-source Model 2	3.368	49.744	294.628	0.806
Closed-source Model 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (Ours)	3.193	49.165	282.429	0.809

Авторы сообщают о более высоком уровне детализации геометрии, точности соответствия условиям и качестве текстурных карт по автоматическим метрикам, а также по результатам пользовательского исследования из 300 кейсов (50 участников), где Hunyuan3D 2.0 превзошла сравниваемые методы по визуальному качеству и соответствию условному изображению.

Репрезентативные производственные сценарии использования

Генерация игровых ассетов: быстрое прототипирование пропсов, элементов окружения, low- и high-poly персонажей или пропсов + запеченные текстуры; модуль стилизации low-poly и запекание текстур Hunyuan3D интегрируются в игровые конвейеры.
3D-электронная коммерция / визуализация продуктов: преобразование фотографий продукта или эскизов в вращаемые 3D-превью товаров для каталогов.
Творческие инструменты / студии: рабочие процессы sketch→3D для художников, автоматическое UV-/texture baking и быстрая итерация при разработке внешнего вида.
AR/VR-контент и быстрое прототипирование: генерация ассетов окружения или пропсов для иммерсивных сценариев с последующей оптимизацией через модуль low-poly stylizer и модули ретаргетинга/анимации.

Как использовать Hunyuan3D 2.0

Шаг 1: Зарегистрируйтесь и получите API-ключ

Войдите на cometapi.com. Если вы еще не являетесь нашим пользователем, сначала зарегистрируйтесь. Войдите в свою консоль CometAPI. Получите учетные данные доступа — API-ключ интерфейса. Нажмите “Add Token” в разделе API token в личном кабинете, получите ключ токена: sk-xxxxx и отправьте его.

Шаг 2: Отправьте запросы в API Hunyuan3D 2.0

Выберите endpoint “"Hunyuan3D-2"”, чтобы отправить API-запрос, и задайте тело запроса. Метод запроса и тело запроса можно получить в нашей API-документации на сайте. Для вашего удобства на нашем сайте также доступен тест Apifox. Замените <YOUR_API_KEY> на ваш фактический ключ CometAPI из учетной записи. base url: Hunyuan3D

Вставьте ваш запрос и изображение в поле content — именно на это модель будет отвечать. Обработайте ответ API, чтобы получить сгенерированный результат.

Hunyuan3D

Шаг 3: Получите и проверьте результаты

Обработайте ответ API, чтобы получить сгенерированный результат. После обработки API возвращает статус задачи и выходные данные.

Цены для Hunyuan3D

Изучите конкурентоспособные цены на Hunyuan3D, разработанные для различных бюджетов и потребностей использования. Наши гибкие планы гарантируют, что вы платите только за то, что используете, что упрощает масштабирование по мере роста ваших требований. Узнайте, как Hunyuan3D может улучшить ваши проекты, сохраняя при этом управляемые расходы.

Цена Comet (USD / M Tokens)	Официальная цена (USD / M Tokens)	Скидка
За запрос:$0.08	За запрос:$0.1	-20%

Пример кода и API для Hunyuan3D

Получите доступ к исчерпывающим примерам кода и ресурсам API для Hunyuan3D, чтобы упростить процесс интеграции. Наша подробная документация предоставляет пошаговые инструкции, помогая вам использовать весь потенциал Hunyuan3D в ваших проектах.

Python
JavaScript
Curl

import os
import requests
import json

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/v1"

# Create output/ folder
folder_path = "output"
os.makedirs(folder_path, exist_ok=True)

# Hunyuan3D-2: 3D model generation from image + prompt
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers={
        "Authorization": f"Bearer {COMETAPI_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "Hunyuan3D-2",
        "prompt": "A cute baby sea otter",
        "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
    }
)

result = response.json()
print(json.dumps(result, indent=2))

# If the response contains a URL or data, save it
if "data" in result and len(result["data"]) > 0:
    data = result["data"][0]
    if "url" in data:
        print(f"
3D Model URL: {data['url']}")
    if "b64_json" in data:
        import base64
        # Save 3D model data if present
        model_data = base64.b64decode(data["b64_json"])
        output_path = os.path.join(folder_path, "hunyuan3d-2-output.glb")
        with open(output_path, "wb") as f:
            f.write(model_data)
        print(f"
3D Model saved to: {output_path}")

Python Code Example

import os
import requests
import json

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/v1"

# Create output/ folder
folder_path = "output"
os.makedirs(folder_path, exist_ok=True)

# Hunyuan3D-2: 3D model generation from image + prompt
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers={
        "Authorization": f"Bearer {COMETAPI_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "Hunyuan3D-2",
        "prompt": "A cute baby sea otter",
        "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
    }
)

result = response.json()
print(json.dumps(result, indent=2))

# If the response contains a URL or data, save it
if "data" in result and len(result["data"]) > 0:
    data = result["data"][0]
    if "url" in data:
        print(f"\n3D Model URL: {data['url']}")
    if "b64_json" in data:
        import base64
        # Save 3D model data if present
        model_data = base64.b64decode(data["b64_json"])
        output_path = os.path.join(folder_path, "hunyuan3d-2-output.glb")
        with open(output_path, "wb") as f:
            f.write(model_data)
        print(f"\n3D Model saved to: {output_path}")

JavaScript Code Example

import fs from "fs";
import path from "path";
import { fileURLToPath } from "url";

const __dirname = path.dirname(fileURLToPath(import.meta.url));

// Get your CometAPI key from https://api.cometapi.com/console/token
const COMETAPI_KEY = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const BASE_URL = "https://api.cometapi.com/v1";

// Create output/ folder
const folderPath = path.join(__dirname, "../output");
if (!fs.existsSync(folderPath)) {
  fs.mkdirSync(folderPath, { recursive: true });
}

// Hunyuan3D-2: 3D model generation from image + prompt
async function generateModel() {
  const response = await fetch(`${BASE_URL}/images/generations`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "Hunyuan3D-2",
      prompt: "A cute baby sea otter",
      image:
        "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2",
    }),
  });

  const result = await response.json();
  console.log(JSON.stringify(result, null, 2));

  // If the response contains a URL or data, save it
  if (result.data && result.data.length > 0) {
    const data = result.data[0];
    if (data.url) {
      console.log(`\n3D Model URL: ${data.url}`);
    }
    if (data.b64_json) {
      // Save 3D model data if present
      const modelData = Buffer.from(data.b64_json, "base64");
      const outputPath = path.join(folderPath, "hunyuan3d-2-output.glb");
      fs.writeFileSync(outputPath, modelData);
      console.log(`\n3D Model saved to: ${outputPath}`);
    }
  }
}

generateModel().catch(console.error);

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY="${COMETAPI_KEY:-<YOUR_COMETAPI_KEY>}"

# Create output/ folder
mkdir -p output

# Hunyuan3D-2: 3D model generation from image + prompt
curl --location --request POST 'https://api.cometapi.com/v1/images/generations' \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "Hunyuan3D-2",
    "prompt": "A cute baby sea otter",
    "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
}'