Hunyuan3D API
Tencent の Hunyuan3D は、可視化やコンテンツのワークフロー向けの、画像から3D、テキストから3D、スケッチから3Dの生成に対応します。V2 の Base、Mini、Multi-View のバリアントに加え、V3 の Image-to-3D、Text-to-3D、Sketch-to-3D のエンドポイントがあります。
V2は、単一画像の3D向けの v2-base と v2-mini、複数画像からの再構築向けの v2-multi-view、スケーラブルなアセット作成向けの v2.1 があります。V3は、image-to-3d(写真からの超高解像度)、text-to-3d(プロンプトからの、テクスチャ付きの完全なモデル)、sketch-to-3d(コンセプトアートからメッシュ)です。
概要
Hunyuan3D APIについて
Hunyuan3Dでできること、Tencentのモデルラインナップにおける位置づけ、そして多くのチームに選ばれる理由。
Hunyuan3DはTencentの3Dアセット生成モデルで、WaveSpeedAIのREST APIから利用できます。Tencent の Hunyuan3D は、可視化やコンテンツのワークフロー向けの、画像から3D、テキストから3D、スケッチから3Dの生成に対応します。V2 の Base、Mini、Multi-View のバリアントに加え、V3 の Image-to-3D、Text-to-3D、Sketch-to-3D のエンドポイントがあります。
V2は、単一画像の3D向けの v2-base と v2-mini、複数画像からの再構築向けの v2-multi-view、スケーラブルなアセット作成向けの v2.1 があります。V3は、image-to-3d(写真からの超高解像度)、text-to-3d(プロンプトからの、テクスチャ付きの完全なモデル)、sketch-to-3d(コンセプトアートからメッシュ)です。
WaveSpeedAIのHunyuan3Dファミリーには、Image-To-3d, Text-To-3dのワークフローをカバーする7個のRESTエンドポイントがあります。各バリアントには、それぞれ独自の料金、パラメーター、作例があります。入力の種類と本番環境の制約に合うものを選ぶか、同じAPIキーで複数を呼び出して、多段階のパイプラインを組み立ててください。
WaveSpeedAIの他の1,000以上のAIモデルと同じAPIキー、請求アカウント、レート制限の枠組みでHunyuan3Dを実行できます。ベンダーごとの設定も、プロバイダーごとのSDKも、ベンダーごとのレート制限も不要です。1つの連携で、テキストから画像、テキストから動画から、音声合成、3D生成、高画質化、編集まで、すべてカバーできます。
エンドポイント
Hunyuan3DのAPIエンドポイント一覧
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の実力を見る
Hunyuan3D APIで実際に生成された出力です。動画にカーソルを合わせるとプレビュー、クリックすると原寸のビューアで開きます。
使い方
Hunyuan3D APIの使い方
登録から生成完了まで4ステップ。Python、Node.js、cURLの完全なサンプルは、下のAPIセクションにあります。
- 01
APIキーを取得
WaveSpeedAIのアカウントに登録し、ダッシュボードからAPIキーをコピーします。新規アカウントには無料のスタータークレジットが付くので、課金が始まる前にプレイグラウンドを数十回実行できます。
- 02
予測を送信
入力をJSONとしてhttps://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-baseにPOSTします。エンドポイントはすぐに予測IDを返します。生成は非同期なので、推論中に接続を開いたままにする必要はありません。
- 03
完了までポーリング
https://api.wavespeed.ai/api/v3/predictions/{request_id}/resultにGETします。completedなら出力を返し、failed、cancelled、timeout、deletedならエラーで停止し、それ以外のステータスの間はポーリングを続けます。
- 04
出力URLを読み取る
ステータスが"completed"になったら、data.outputs[0]からURLを読み取ります。URLは、WaveSpeedAIのCDN上にある生成されたメディアを指します。呼び出したHunyuan3Dのバリアントに応じて、画像、動画、音声、3Dファイルのいずれかです。
活用例
Hunyuan3Dで作れるもの
開発者やクリエイターがHunyuan3D APIでよく使うワークフロー。
単一画像から3Dアセット
wavespeed-ai/hunyuan3d/v2-base は、Tencent による最先端の Image-to-3D モデルで、可視化やコンテンツのために画像を3Dアセットに変換します。商品やキャラクターのメッシュ生成の、標準的なエンドポイントです。
軽量な Mini バリアント
wavespeed-ai/hunyuan3d/v2-mini は、Tencent のコンパクトな画像から3Dの生成モデルです。素早い試行、モバイルでのプレビュー、メッシュのディテールを後工程で磨けるパイプラインに便利です。
マルチビューからの再構築
wavespeed-ai/hunyuan3d/v2-multi-view は、複数の画像から正確な3D再構築を生成します。正面、側面、背面のビューを渡すと、隠れた面のジオメトリがより確かになります。
v2.1 によるスケーラブルなアセット作成
wavespeed-ai/hunyuan3d/v2.1 は、最先端の3D生成を前進させた、Tencent のスケーラブルな3Dアセット作成システムです。より高い精細さが必要な、制作向けのアセットのワークフロー用のバリアントです。
V3 のプロンプトからのテキストから3D
wavespeed-ai/hunyuan3d-v3/text-to-3d は、テキストプロンプトを、精細でテクスチャ付きの完全な3Dモデルに変換します。元の画像なしで、説明からアセットを生成できます。
コンセプトアート向けの V3 スケッチから3D
wavespeed-ai/hunyuan3d-v3/sketch-to-3d は、手描きのスケッチやコンセプトアートを、精細な3Dモデルに変換します。初期段階のデザインの検討に便利です。
コツ
Hunyuan3Dのプロンプトのコツ
Hunyuan3Dからより良い出力を得るための実践的なアドバイス。本番のパイプラインで3Dモデル全般に通用するパターンに基づいています。
- 01
隠れたジオメトリにはマルチビュー
正面、側面、背面の写真があるときは、v2-multi-view を使ってください。単一画像の Base/Mini は隠れた面を推測しますが、マルチビューは正確に再構築します。
- 02
素早い試行には Mini
コンセプトの検討中の素早いプレビュー用メッシュには v2-mini を使い、ジオメトリの方向性が固まったら v2-base または v2.1 に切り替えます。
- 03
きれいで明るい元画像
画像から3Dの品質は、元の写真の質がボトルネックになります。均一な照明、少ない影、はっきりした被写体のシルエットが、よりきれいなメッシュを生みます。
- 04
PBRの要件は後工程で指定する
Hunyuan3D は可視化用のメッシュを出力します。生成後に、DCCツールやレンダリングエンジンで、テクスチャリングとPBRマテリアルの工程を計画してください。
- 05
無地の背景での商品写真
白やニュートラルな背景のECの商品写真が、最もきれいにジオメトリを抽出できます。背景が複雑だと、再構築したメッシュにノイズが増えます。
料金
Hunyuan3D APIの料金
料金は出力ごとです。最終的な請求額は、各バリアントのプレイグラウンドで設定するパラメーター(解像度、長さ、出力数、参照入力)に応じて変わります。
| エンドポイント | タイプ | 最低料金 |
|---|---|---|
| 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
Hunyuan3D APIを呼び出す
wavespeed.ai/accesskeyでAPIキーに登録し、RESTで予測を送信します。プレイグラウンドでは、入力の組み合わせに応じて、そのまま貼り付けられるサンプルが生成されます。
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と他モデルの比較
WaveSpeedAI上の類似モデルではなくHunyuan3Dを選ぶべきケース。
Hunyuan3D vs Tripo3D
Tripo3D は、テクスチャのベイクを備えた高速な画像から3Dを提供します。Hunyuan3D は、Tencent の研究基盤による複数の品質階層(Base、Mini、Multi-View、v2.1)をカバーします。入力の種類(単一ビューか複数ビューか)と必要な精細さで選んでください。
Hunyuan3D vs Meshy
Meshy は、ウェブ中心の3D生成ツールです。Hunyuan3D は WaveSpeedAI でAPIファーストなので、手動のUI操作なしで、自動化されたパイプライン、アセットのバッチ生成、SaaS連携に向いています。
Hunyuan3D vs Manual photogrammetry
フォトグラメトリは、数十枚の写真と長い処理時間が必要です。Hunyuan3D は、1枚または数枚の画像から、使えるメッシュを数秒で生成します。プロトタイピングには高速ですが、スキャン品質の再構築には精度が劣ります。
FAQ
Hunyuan3D API — よくある質問
料金、ライセンス、連携など、WaveSpeedAIでHunyuan3Dを実行する際のよくある質問。
Hunyuan3D APIとは何ですか?
Hunyuan3Dは、Tencentの3Dモデルで、WaveSpeedAI上でREST APIとして提供されています。Tencent の Hunyuan3D は、可視化やコンテンツのワークフロー向けの、画像から3D、テキストから3D、スケッチから3Dの生成に対応します。V2 の Base、Mini、Multi-View のバリアントに加え、V3 の Image-to-3D、Text-to-3D、Sketch-to-3D のエンドポイントがあります。プログラムから呼び出すことも、上にリンクされたプレイグラウンドで試すこともできます。
Hunyuan3D APIはどう呼び出しますか?
WaveSpeedAIのアカウントに登録し、/accesskeyからAPIキーをコピーして、入力をJSONとしてhttps://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-baseにPOSTします。エンドポイントは予測IDを返します。結果のエンドポイントを約2秒ごとにポーリングし、長時間かかるタスクでは間隔を広げ、終端ステータスになったら停止してください。本番運用向けのPython / Node.js / cURLのサンプルは上にあります。
Hunyuan3D APIの料金はいくらですか?
Hunyuan3Dは1回あたり$0.12からです。実際の料金は、設定するパラメーター(解像度、長さ、出力数、参照入力)に応じて変わります。プレイグラウンドの「生成」ボタンの横に表示されるリアルタイムの料金プレビューで、現在の入力での正確な料金を確認できます。
Hunyuan3Dにはどのバリアントがありますか?
WaveSpeedAIでは、7個のHunyuan3Dエンドポイントが利用可能です: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。各バリアントには、専用のプレイグラウンドページと料金があります。
Hunyuan3Dの出力を商用利用できますか?
商用利用の権利は、Tencentのモデルライセンスに従います。Tencentのほとんどのモデルは出力の商用利用を認めています。具体的なライセンスの概要は各モデルのプレイグラウンドページで、プラットフォーム全体の条件はWaveSpeedAIの利用規約でご確認ください。
なぜ直接ではなくWaveSpeedAIでHunyuan3Dを使うのですか?
Hunyuan3Dと、他のプロバイダーの1,000以上のAIモデルを、1つのAPIキー、1つの請求アカウントで利用できます。ベンダーごとのSDK設定も、個別のレート制限も、ベンダーごとの連携コードの書き直しも不要です。料金は、通常Tencentの直接のAPIと同等かそれ以下です。
提供元
Tencentについて
WaveSpeedAIにおけるHunyuan3Dと、Tencentのモデルラインナップ全体を手がけるチーム。
Tencent の Hunyuan チームは、写真を、可視化、ゲームアセット、ECのための3Dメッシュに変換する、画像から3Dモデルのファミリー、Hunyuan3D を開発しています。バリアントは、単一画像からの生成、軽量な Mini による推論、マルチビューからの再構築、スケーラブルなアセット作成システムの v2.1 をカバーします。
WaveSpeedAIでHunyuan3Dを使った開発を始めよう
登録時に無料のスタータークレジットを進呈。Tencentをはじめ、あらゆるプロバイダーの1,000以上のAIモデルを、1つのAPIキーで。