Hunyuan3D API
騰訊 Hunyuan3D 提供圖片轉 3D、文字轉 3D 與草圖轉 3D 生成,適用於視覺化與內容工作流程。包含 V2 Base、Mini 與 Multi-View 版本,以及 V3 圖片轉 3D、文字轉 3D 與草圖轉 3D 端點。
V2:v2-base 與 v2-mini 用於單張圖片轉 3D;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 使用。騰訊 Hunyuan3D 提供圖片轉 3D、文字轉 3D 與草圖轉 3D 生成,適用於視覺化與內容工作流程。包含 V2 Base、Mini 與 Multi-View 版本,以及 V3 圖片轉 3D、文字轉 3D 與草圖轉 3D 端點。
V2:v2-base 與 v2-mini 用於單張圖片轉 3D;v2-multi-view 用於由多張圖片重建;v2.1 用於可擴展的資產製作。V3:image-to-3d(由照片生成超高解析度模型)、text-to-3d(由提示詞生成完整貼圖的模型)與 sketch-to-3d(將概念圖轉為網格)。
WaveSpeedAI 上的 Hunyuan3D 系列提供 7 個 REST 端點,涵蓋 Image-To-3d, Text-To-3d 等工作流程。每個變體都有各自的定價、參數選項與範例輸出 — 請挑選符合您輸入模態與生產限制的版本,或使用同一組 API 金鑰呼叫多個變體,組合成多步驟的處理流程。
使用您呼叫其他 1,000+ 個 WaveSpeedAI AI 模型時相同的 API 金鑰、帳單帳戶與速率限制額度來執行 Hunyuan3D。無需另外設定供應商、無需各家 SDK、無需處理各家不同的速率限制 — 一次整合,涵蓋從文字轉圖片、文字轉影片,到音訊合成、3D 生成、放大與編輯的所有功能。
端點
所有 Hunyuan3D API 端點
WaveSpeedAI 目前提供 7 個 Hunyuan3D 端點 — 請選擇符合您工作流程的變體。
/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
從註冊到完成生成,只要四個步驟。完整的 Python、Node.js 與 cURL 範例請見下方的 API 區段。
- 01
取得 API 金鑰
註冊 WaveSpeedAI 帳號,並從控制台複製您的 API 金鑰。新帳號會獲贈免費入門點數 — 足以在開始計費前執行數十次 Playground。
- 02
提交 prediction
將您的輸入以 JSON 格式 POST 到 https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base。端點會立即回傳 prediction id — 生成是非同步進行的,因此推論期間您不需要保持連線。
- 03
輪詢完成狀態
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。狀態為 completed 時回傳輸出;狀態為 failed、cancelled、timeout 或 deleted 時停止並回報錯誤;其他狀態則持續輪詢。
- 04
讀取輸出網址
當狀態為 "completed" 時,從 data.outputs[0] 讀取網址。該網址指向 WaveSpeedAI CDN 上您生成的媒體 — 依您呼叫的 Hunyuan3D 變體,可能是圖片、影片、音訊或 3D 檔案。
應用情境
您可以用 Hunyuan3D 打造什麼
開發者與創作者使用 Hunyuan3D API 的常見工作流程。
單張圖片轉 3D 資產
wavespeed-ai/hunyuan3d/v2-base 是騰訊推出的最先進圖片轉 3D 模型,可將圖片轉為用於視覺化與內容的 3D 資產,是產品與角色網格生成的預設端點。
輕量的 Mini 版本
wavespeed-ai/hunyuan3d/v2-mini 是騰訊的精簡圖片轉 3D 生成模型,適合快速迭代、行動裝置預覽,以及網格細節可於下游再精修的管線。
多視角重建
wavespeed-ai/hunyuan3d/v2-multi-view 可由多張圖片生成精準的 3D 重建,提供正面、側面與背面視角,可讓被遮擋表面的幾何更為準確。
v2.1 可擴展的資產製作
wavespeed-ai/hunyuan3d/v2.1 是騰訊推出的可擴展 3D 資產製作系統,推進了最先進的 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
使用中性背景的產品照片
電商產品照若使用白色或中性背景,幾何擷取最乾淨;雜亂的背景會為重建的網格增添雜訊。
定價
Hunyuan3D API 定價
依輸出計費。最終費用會依您在各變體 Playground 中設定的參數(解析度、時長、輸出數量、參考素材)而調整。
| 端點 | 類型 | 起始價格 |
|---|---|---|
| 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 提交 prediction。Playground 會為任何輸入組合產生可直接貼上的範例。
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 則涵蓋騰訊研究體系下的多個品質等級(Base、Mini、Multi-View、v2.1),可依輸入類型(單視角或多視角)與保真度需求選擇。
Hunyuan3D vs Meshy
Meshy 是以網頁為優先的 3D 生成工具。Hunyuan3D 在 WaveSpeedAI 上以 API 為優先,更適合自動化管線、批次資產生成與 SaaS 整合,不需手動操作介面。
Hunyuan3D vs Manual photogrammetry
攝影測量需要數十張照片與漫長的處理時間。Hunyuan3D 可在數秒內由一張或數張圖片生成可用的網格,原型製作更快,但不如掃描等級的重建精準。
常見問題
Hunyuan3D API — 常見問題
定價、授權、整合 — 關於在 WaveSpeedAI 上執行 Hunyuan3D 的常見問題。
什麼是 Hunyuan3D API?
Hunyuan3D 是 Tencent 的3D模型,在 WaveSpeedAI 上以 REST API 提供。騰訊 Hunyuan3D 提供圖片轉 3D、文字轉 3D 與草圖轉 3D 生成,適用於視覺化與內容工作流程。包含 V2 Base、Mini 與 Multi-View 版本,以及 V3 圖片轉 3D、文字轉 3D 與草圖轉 3D 端點。您可以透過程式呼叫,也可以在上方連結的 Playground 試用。
如何呼叫 Hunyuan3D API?
註冊 WaveSpeedAI 帳號,從 /accesskey 複製您的 API 金鑰,然後將您的輸入以 JSON 格式 POST 到 https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base。端點會回傳 prediction id。請從約每 2 秒輪詢一次結果端點開始,長時間任務可拉長間隔,並在任何終止狀態時停止。上方提供適用於生產環境的 Python / Node.js / cURL 範例。
Hunyuan3D API 的費用是多少?
Hunyuan3D 每次執行 $0.12 起。實際費用會依您設定的參數(解析度、時長、輸出數量、參考素材)而調整。Playground 中「生成」按鈕旁的即時費用預覽會顯示您目前輸入的確切價格。
有哪些 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。每個變體都有各自的 Playground 頁面與定價。
Hunyuan3D 的輸出可以商用嗎?
商業使用權依 Tencent 的模型授權而定。多數 Tencent 模型允許商用輸出;請參閱各模型 Playground 頁面中的授權摘要,以及 WaveSpeedAI 的服務條款了解平台層級的條件。
為什麼要在 WaveSpeedAI 上使用 Hunyuan3D,而不是直接使用?
一組 API 金鑰、一個帳單帳戶,即可使用 Hunyuan3D 以及來自其他供應商的 1,000+ 個 AI 模型。無需設定各家 SDK、無需處理各自獨立的速率限制、無需為每個供應商重寫整合程式碼。價格通常與 Tencent 的直接 API 相當或更低。
提供者
關於 Tencent
Hunyuan3D 背後的團隊,以及 Tencent 在 WaveSpeedAI 上的完整模型陣容。
騰訊的混元團隊打造了 Hunyuan3D,這是一系列圖片轉 3D 的模型,可將照片轉為 3D 網格,用於視覺化、遊戲資產與電商。版本涵蓋單張圖片生成、輕量的 Mini 推論、多視角重建,以及 v2.1 可擴展資產製作系統。
在 WaveSpeedAI 上開始使用 Hunyuan3D 打造應用
註冊即贈免費入門點數。一組 API 金鑰,涵蓋來自 Tencent 與所有其他供應商的 1,000+ 個 AI 模型。