O que é o Hunyuan3D 2.0 ?

Definição breve: Hunyuan3D 2.0(*Hunyuan3D-2*) é um sistema generativo de grande escala em duas etapas da Tencent para produzir assets 3D texturizados em alta resolução a partir de entradas multimodais (texto, 1–4 imagens, esboços). O sistema separa a geração de forma (Hunyuan3D-DiT / ShapeVAE) e a síntese de textura (Hunyuan3D-Paint), além de uma UI/plataforma de produção (Hunyuan3D-Studio).

Principais recursos

Entradas multimodais: texto‑para‑3D, imagem‑para‑3D (1–4 vistas), esboço‑para‑3D. O site global e a documentação listam explicitamente esses modos.
Pipeline em duas etapas:
1. Geração de forma — Hunyuan3D-DiT (difusão latente/flow‑matching nos latentes do ShapeVAE) produz uma malha básica.
2. Síntese de textura — Hunyuan3D-Paint gera imagens multivisualizações condicionadas à geometria; as saídas são bakeadas em mapas de textura de alta resolução.
Formatos de saída e integração: exporta formatos 3D comuns (OBJ, GLB) e foi projetado para integrar‑se ao Unity, Unreal, Blender e pipelines de produção padrão. A API corporativa oferece suporte à geração de materiais PBR e opções de topologia (triângulos/quads).
Recursos de produção: topologia inteligente (otimização de malha), estilização low‑poly, bake de textura e suporte a animação no estúdio (skinning esquelético via GNN para retargeting simples no Hunyuan3D-Studio).

Desempenho de benchmark (métricas publicadas)

Do relatório técnico/avaliação do Hunyuan3D 2.0 (métricas representativas da Tabela 4 do artigo; CLIP‑score mais alto é melhor; métricas CMMD / FID mais baixas são melhores):

Modelo	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (baseline de código aberto)	3.591	54.639	289.287	0.787
Modelo de código fechado 1	3.600	55.866	305.922	0.779
Modelo de código fechado 2	3.368	49.744	294.628	0.806
Modelo de código fechado 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (Nosso)	3.193	49.165	282.429	0.809

Os autores relatam detalhes geométricos superiores, fidelidade de alinhamento à condição e qualidade dos mapas de textura em métricas automáticas e em um estudo com 300 casos (50 participantes), no qual o Hunyuan3D 2.0 superou os métodos comparativos em qualidade visual e aderência à imagem condicional.

Casos de uso de produção representativos

Geração de assets para jogos: prototipagem rápida de props, cenários, malhas de personagens ou objetos em low e high‑poly + texturas bakeadas; o módulo de estilização low‑poly do Hunyuan3D + bake de textura se integram aos pipelines de jogos.
E‑commerce 3D / visualização de produtos: converta fotos de produtos ou esboços em prévias 3D rotacionáveis para catálogos.
Ferramentas / estúdios criativos: fluxos de trabalho de esboço→3D para artistas, bake automático de UV/textura e iteração rápida para look development.
Conteúdo de AR/VR e prototipagem rápida: gere assets de ambiente ou props para experiências imersivas e, em seguida, otimize por meio do estilizador low‑poly e dos módulos de retargeting/animação.

Como usar o Hunyuan3D 2.0

Etapa 1: Cadastre-se para obter a chave de API

Faça login em cometapi.com. Se você ainda não é nosso usuário, registre-se primeiro. Acesse seu console do CometAPI. Obtenha a chave de API de credenciais de acesso da interface. Clique em “Add Token” no token de API no centro pessoal, obtenha a chave do token: sk-xxxxx e envie.

Etapa 2: Envie solicitações para a API do Hunyuan3D 2.0

Selecione o endpoint “"Hunyuan3D-2"” para enviar a solicitação à API e definir o corpo da requisição. O método e o corpo da requisição são obtidos na documentação da API do nosso site. Nosso site também fornece teste no Apifox para sua conveniência. Substitua <YOUR_API_KEY> pela sua chave real do CometAPI na sua conta. O URL base é Hunyuan3D

Insira sua solicitação e imagem no campo content — é a isso que o modelo responderá. Processe a resposta da API para obter a resposta gerada.

Hunyuan3D

Etapa 3: Recuperar e verificar os resultados

Processe a resposta da API para obter a resposta gerada. Após o processamento, a API responde com o status da tarefa e os dados de saída.

Preços para Hunyuan3D

Explore preços competitivos para Hunyuan3D, projetado para atender diversos orçamentos e necessidades de uso. Nossos planos flexíveis garantem que você pague apenas pelo que usar, facilitando o dimensionamento conforme suas necessidades crescem. Descubra como Hunyuan3D pode aprimorar seus projetos mantendo os custos gerenciáveis.

Preço do Comet (USD / M Tokens)	Preço Oficial (USD / M Tokens)	Desconto
Por Solicitação:$0.08	Por Solicitação:$0.1	-20%

Código de exemplo e API para Hunyuan3D

Acesse código de exemplo abrangente e recursos de API para Hunyuan3D para otimizar seu processo de integração. Nossa documentação detalhada fornece orientação passo a passo, ajudando você a aproveitar todo o potencial do Hunyuan3D em seus projetos.

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"
}'