Hunyuan3D 2.0とは？

短い定義： Hunyuan3D 2.0(*Hunyuan3D-2*) は、Tencent による二段階の大規模生成システムであり、マルチモーダル入力（テキスト、1〜4枚の画像、スケッチ）から高解像度のテクスチャ付き 3D アセットを生成します。このシステムは、形状生成（Hunyuan3D-DiT / ShapeVAE）とテクスチャ合成（Hunyuan3D-Paint）を分離しており、さらに制作向け UI / プラットフォーム（Hunyuan3D-Studio）も備えています。

主な特徴

マルチモーダル入力： Text-to-3D、Image-to-3D（1〜4視点）、Sketch-to-3D。グローバルサイトとドキュメントでは、これらのモードが明示的に記載されています。
二段階パイプライン：
1. 形状生成 — Hunyuan3D-DiT（ShapeVAE の潜在表現に対する latent diffusion / flow-matching）がベアメッシュを生成します。
2. テクスチャ合成 — Hunyuan3D-Paint は、ジオメトリを条件としてマルチビュー画像を生成し、出力は高解像度テクスチャマップにベイクされます。
出力形式と統合： 一般的な 3D 形式（OBJ、GLB）をエクスポートでき、Unity、Unreal、Blender、および標準的な制作パイプラインとの統合を前提に設計されています。エンタープライズ API は、PBR マテリアル生成とトポロジーオプション（三角形 / 四角形）をサポートしています。
制作向け機能： スマートトポロジー（メッシュ最適化）、ローポリスタイライズ、テクスチャベイク、さらにスタジオ内アニメーション対応（Hunyuan3D-Studio における、簡易リターゲティング用の GNN によるスケルタルスキニング）。

ベンチマーク性能（公開指標）

Hunyuan3D 2.0 の technical report / evaluation より（論文 Table 4 の代表的指標。CLIP-score は高いほど良く、CMMD / FID 指標は低いほど良い）：

Model	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (オープンソースのベースライン)	3.591	54.639	289.287	0.787
クローズドソース Model 1	3.600	55.866	305.922	0.779
クローズドソース Model 2	3.368	49.744	294.628	0.806
クローズドソース 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 がジオメトリの詳細さ、条件との整合性、テクスチャマップ品質で優れていると報告しており、視覚品質と条件画像への忠実性の両面で比較手法を上回ったとしています。

代表的な制作ユースケース

ゲームアセット生成： プロップ、背景オブジェクト、ローポリ / ハイポリのキャラクターまたはプロップメッシュ + ベイク済みテクスチャの高速プロトタイピング。Hunyuan3D のローポリスタイライズモジュールとテクスチャベイクはゲームパイプラインに統合できます。
3D EC / 製品ビジュアライゼーション： 製品写真やスケッチを、カタログ向けの回転可能な 3D 製品プレビューに変換します。
クリエイティブツール / スタジオ： アーティスト向けの sketch→3D ワークフロー、自動 UV / テクスチャベイク、ルック開発のための迅速な反復。
AR/VR コンテンツと高速プロトタイピング： 没入型体験向けの環境アセットやプロップを生成し、その後ローポリスタイライザーやリターゲティング / アニメーションモジュールで最適化します。

Hunyuan3D 2.0 の使い方

Step 1: API キーを取得する

cometapi.com にログインします。まだユーザーでない場合は、先に登録してください。CometAPI console にサインインします。インターフェースのアクセス認証情報である API キーを取得します。個人センターの API token で「Add Token」をクリックし、token key: sk-xxxxx を取得して送信します。

Step 2: Hunyuan3D 2.0 API にリクエストを送信する

API リクエストを送信するには、「"Hunyuan3D-2"」エンドポイントを選択し、request body を設定します。request method と request body は当社サイトの API doc で確認できます。利便性のために、当社サイトでは Apifox テストも提供しています。<YOUR_API_KEY> を、アカウントの実際の CometAPI キーに置き換えてください。base url は Hunyuan3D です。

リクエストと画像を content field に挿入してください。モデルはこれに対して応答します。API response を処理して生成された answer を取得します。

Hunyuan3D

Step 3: 結果を取得して確認する

API response を処理して生成された answer を取得します。処理後、API はタスクのステータスと出力データを返します。

Hunyuan3Dの料金

Hunyuan3Dの競争力のある価格設定をご確認ください。さまざまな予算や利用ニーズに対応できるよう設計されています。柔軟なプランにより、使用した分だけお支払いいただけるため、要件の拡大に合わせて簡単にスケールアップできます。Hunyuan3Dがコストを管理しながら、お客様のプロジェクトをどのように強化できるかをご覧ください。

コメット価格 (USD / M Tokens)	公式価格 (USD / M Tokens)	割引
リクエストごと:$0.08	リクエストごと:$0.1	-20%

Hunyuan3DのサンプルコードとAPI

Hunyuan3Dの包括的なサンプルコードとAPIリソースにアクセスして、統合プロセスを効率化しましょう。詳細なドキュメントでは段階的なガイダンスを提供し、プロジェクトで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"
}'