Official Hi3D v1.0: high-resolution 3D geometry refinement built on Sparc3D. Inference code, model weights, and documentation.

Hi3D v1.0 — 機能概要

Hi3D v1.0は、3Dジオメトリ精細化ツールです。以下の2つを入力として使用します：

粗い3Dメッシュ（オブジェクトのラフで低精細な3Dモデル）
そのオブジェクトの 参照画像

これにより、高解像度でより詳細な3Dメッシュが生成されます。層状のレリーフ、建築のモールディング、曲線の境界、鱗、歯、同心円状の溝などの細かい表面ディテールが追加されます。

本ツールは、以前のシステムである Sparc3D をベースに構築されており、互換性のためにSparc3Dの内部名称（sparc3d、Sparc3DPipeline）を保持しています。

仕組み

システムは パス（段階） ごとに動作します。各パスでメッシュがより高い解像度で精細化されます：

パス	構造グリッド	抽出グリッド
1	64³	512³
2	128³	1024³
3	192³	1536³

512³ のリクエストは1パスを実行します。
1024³ のリクエストは2パスを実行します。
1536³ のリクエストは3パスすべてを実行します。

各パスでは、スパースなデータポイントをサンプリングし、ニューラルネットワークでデコードしてメッシュを抽出し、次のパスに送るためにそのメッシュを再ボクセル化（再グリッド化）します。参照画像がプロセス全体を通じて精細化をガイドします。

生成されるもの

ジオメトリのみ。 テクスチャ、マテリアル、頂点カラーは含まれません。
出力は 再センタリングおよび正規化 され、単位最大半径に調整されます。元のワールド座標やスケールは保持されません。
隠れた表面（画像で見えない部分）は 妥当な補完 であり、正確な再構築ではありません。

要件

Linux, Python 3.10
NVIDIA GPU（計算能力8.0以上、例：H20, A100クラス）
CUDA toolkit 12.0–12.5
CPU推論パスは存在しません
1536³設定は 96 GB NVIDIA H20 でのみ検証済みです。小規模なGPUでのメモリ要件は不明です

含まれるもの / 含まれないもの

含まれるもの：

推論コード（Pythonパッケージ + コマンドラインツール）
Hugging Face上のモデルアーティファクト（8ファイル：設定 + モデル重み）
Hunyuan3D-2 mini（サードパーティ製粗メッシュ生成器）用のオプションアダプター

含まれないもの：

学習コード
論文の評価用ハーネス
ベンチマーク分割や比較用メッシュ

使用方法

Python API：

from PIL import Image
import trimesh
from sparc3d import Sparc3DPipeline

pipeline = Sparc3DPipeline.from_pretrained(
    "hi3d-official/Hi3Dv1.0",
).to("cuda")

result = pipeline(
    Image.open("input.png"),
    trimesh.load("coarse.glb", force="mesh", process=False),
    resolution=1024,
    num_inference_steps=25,
    seed=0,
)
result.mesh.export("refined.glb")

サポートされている解像度：512, 1024, 1536。デフォルト：パスごとに25回のスケジューラー更新。

コマンドライン：

python demo/refine_mesh.py \
  --model hi3d-official/Hi3Dv1.0 \
  --image input.png --coarse-mesh coarse.glb --output refined.glb \
  --resolution 1024 --num-inference-steps 25 --seed 0

主な制限と注意点

粗い構造が重要です。 入力メッシュの深刻なエラーは出力にも残る可能性があります。
シード値は保証ではありません。 GPU操作はビット単位で決定的ではありません。同じシードと入力でも、わずかに異なるメッシュが生成されることがあります。
GPUカーネルが必須です。 flash-attn にフォールバックはなく、コンパイルに成功する必要があります。
解像度はリクエストであり、約束ではありません。 目標解像度に達しない場合、コードは低品質な結果を黙って返すのではなく、エラーを発生させます。
背景削除はオプトインです（demo エクストラパッケージのインストールが必要）。

ライセンスと商用条件

Hi3D Open License Agreement Version 1.0 に準拠します：

商用利用が可能です。
本ツールを使用する製品が 月間アクティブユーザー数200,000人 または 月間収益1,000,000米ドル を超える場合、ライセンサーに通知し、60日以内 に個別の書面によるライセンスを申請する必要があります。
商用統合には、公式サイトへのリンクを含む "Powered by Hi3D 1.0" の表示が必要です。
スタンドアロン出力（Hi3Dマテリアルやモデルの派生物を含まないメッシュ）は、ブランディングや規模に応じたライセンス義務の対象外です。
既存の Apache-2.0 および MIT 条項は、オリジナルの部分やサードパーティの部分に引き続き適用されます。
サードパーティ製コンポーネント（Hunyuan3D-2, DINOv2, CLIP）は、それぞれのライセンスを保持します。

クイックファクト

リリース日： 2026年10月23日
学習データ： 約200万件のキュレーションされた3Dアセット（技術レポートによる）
ライブデモ： Hugging Face Spacesで利用可能
連絡先： contact@hi3d.ai

hi3d-official/Hi3Dv1.0