Hunyuan3D API
Tencent Hunyuan3D — tạo 3D từ ảnh, từ văn bản và từ phác thảo cho quy trình trực quan hóa và nội dung. Các biến thể V2 Base, Mini và Multi-View cùng các endpoint V3 Image-to-3D, Text-to-3D và Sketch-to-3D.
V2: v2-base và v2-mini cho 3D từ một ảnh; v2-multi-view để tái dựng từ nhiều ảnh; v2.1 để tạo tài sản có thể mở rộng. V3: image-to-3d (độ phân giải cực cao từ ảnh chụp), text-to-3d (mô hình đầy đủ texture từ prompt) và sketch-to-3d (từ concept art thành mesh).
Tổng quan
Giới thiệu về Hunyuan3D API
Hunyuan3D làm được gì, nằm ở đâu trong dòng mô hình của Tencent, và vì sao các đội ngũ chọn nó.
Hunyuan3D là mô hình tạo tài sản 3D từ Tencent, có sẵn qua REST API của WaveSpeedAI. Tencent Hunyuan3D — tạo 3D từ ảnh, từ văn bản và từ phác thảo cho quy trình trực quan hóa và nội dung. Các biến thể V2 Base, Mini và Multi-View cùng các endpoint V3 Image-to-3D, Text-to-3D và Sketch-to-3D.
V2: v2-base và v2-mini cho 3D từ một ảnh; v2-multi-view để tái dựng từ nhiều ảnh; v2.1 để tạo tài sản có thể mở rộng. V3: image-to-3d (độ phân giải cực cao từ ảnh chụp), text-to-3d (mô hình đầy đủ texture từ prompt) và sketch-to-3d (từ concept art thành mesh).
Họ Hunyuan3D trên WaveSpeedAI cung cấp 7 endpoint REST bao gồm 2 quy trình Image-To-3d, Text-To-3d. Mỗi biến thể có giá, các tham số điều chỉnh và kết quả mẫu riêng — hãy chọn biến thể phù hợp với dạng đầu vào và ràng buộc sản xuất của bạn, hoặc gọi nhiều biến thể từ cùng một API key để ghép các pipeline nhiều bước.
Chạy Hunyuan3D bằng cùng API key, tài khoản thanh toán và hạn mức tốc độ bạn dùng cho hơn 1.000 mô hình AI khác trên WaveSpeedAI. Không cần thiết lập nhà cung cấp riêng, không cần SDK cho từng nhà cung cấp, không có hạn mức tốc độ riêng của từng hãng — một lần tích hợp bao quát mọi thứ, từ text-to-image và text-to-video đến tổng hợp âm thanh, tạo 3D, nâng cấp và chỉnh sửa.
Endpoint
Tất cả endpoint API Hunyuan3D
7 endpoint Hunyuan3D hiện có sẵn trên WaveSpeedAI — hãy chọn biến thể phù hợp với quy trình của bạn.
/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.
Ví dụ
Xem Hunyuan3D hoạt động
Kết quả thật do API Hunyuan3D tạo ra. Rê chuột lên video để xem trước, nhấp để mở trình xem kích thước đầy đủ.
Hướng dẫn
Cách dùng API Hunyuan3D
Bốn bước từ đăng ký đến khi có kết quả. Ví dụ đầy đủ bằng Python, Node.js và cURL nằm ở phần API bên dưới.
- 01
Lấy API key
Đăng ký tài khoản WaveSpeedAI và sao chép API key từ bảng điều khiển. Tài khoản mới được tặng credit dùng thử miễn phí — đủ để chạy playground vài chục lần trước khi bắt đầu tính phí.
- 02
Gửi một prediction
POST đầu vào của bạn dưới dạng JSON tới https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. Endpoint trả về prediction id ngay lập tức — việc tạo là bất đồng bộ nên bạn không phải giữ kết nối mở trong lúc suy luận.
- 03
Poll để chờ hoàn tất
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Trả về kết quả khi completed; dừng và báo lỗi khi failed, cancelled, timeout hoặc deleted; tiếp tục poll với mọi trạng thái khác.
- 04
Đọc URL kết quả
Khi status là "completed", đọc URL từ data.outputs[0]. URL trỏ tới media bạn đã tạo trên CDN của WaveSpeedAI — ảnh, video, âm thanh hoặc tệp 3D tùy biến thể Hunyuan3D bạn đã gọi.
Trường hợp sử dụng
Bạn có thể xây dựng gì với Hunyuan3D
Các quy trình phổ biến mà nhà phát triển và người sáng tạo dùng API Hunyuan3D cho.
Từ một ảnh thành tài sản 3D
wavespeed-ai/hunyuan3d/v2-base là mô hình Image-to-3D tiên tiến của Tencent biến ảnh thành tài sản 3D cho trực quan hóa và nội dung — endpoint mặc định để tạo mesh sản phẩm và nhân vật.
Biến thể Mini nhẹ
wavespeed-ai/hunyuan3d/v2-mini là mô hình sinh image-to-3D gọn nhẹ của Tencent — hữu ích để lặp thử nhanh, xem trước trên thiết bị di động và các pipeline có thể tinh chỉnh chi tiết mesh ở khâu sau.
Tái dựng từ nhiều góc nhìn
wavespeed-ai/hunyuan3d/v2-multi-view tạo bản tái dựng 3D chính xác từ nhiều ảnh — cung cấp góc trước, bên và sau để có hình học tốt hơn ở các bề mặt bị che khuất.
v2.1 tạo tài sản có thể mở rộng
wavespeed-ai/hunyuan3d/v2.1 là hệ thống tạo tài sản 3D có thể mở rộng của Tencent, nâng tầm tạo 3D tiên tiến — biến thể cho quy trình tài sản sản xuất cần độ trung thực cao hơn.
V3 text-to-3D từ prompt
wavespeed-ai/hunyuan3d-v3/text-to-3d biến prompt văn bản thành mô hình 3D chi tiết, đầy đủ texture — tạo tài sản từ mô tả mà không cần ảnh nguồn.
V3 sketch-to-3D cho concept art
wavespeed-ai/hunyuan3d-v3/sketch-to-3d chuyển bản phác thảo vẽ tay và concept art thành mô hình 3D chi tiết — hữu ích để khám phá thiết kế giai đoạn đầu.
Mẹo
Mẹo viết prompt cho Hunyuan3D
Lời khuyên thực tế để có kết quả tốt hơn từ Hunyuan3D — rút ra từ các mẫu hiệu quả trên các mô hình 3D trong các pipeline sản xuất.
- 01
Multi-view cho hình học bị che khuất
Khi có ảnh mặt trước, bên và sau, hãy dùng v2-multi-view — Base/Mini một ảnh phải đoán các bề mặt bị che khuất; multi-view tái dựng chúng chính xác.
- 02
Mini để lặp thử nhanh
v2-mini cho mesh xem trước nhanh khi khám phá ý tưởng; chuyển sang v2-base hoặc v2.1 khi hướng hình học đã chốt.
- 03
Ảnh nguồn sạch, đủ sáng
Chất lượng image-to-3D bị nút thắt ở chất lượng ảnh nguồn. Ánh sáng đều, bóng đổ tối thiểu và đường viền chủ thể rõ ràng cho mesh sạch hơn.
- 04
Nêu kỳ vọng PBR ở khâu sau
Hunyuan3D xuất mesh để trực quan hóa — hãy lên kế hoạch cho bước texture và vật liệu PBR trong công cụ DCC hoặc engine render sau khi tạo.
- 05
Ảnh sản phẩm trên nền trung tính
Ảnh sản phẩm thương mại điện tử trên nền trắng/trung tính cho trích xuất hình học sạch nhất — nền rối làm mesh tái dựng thêm nhiễu.
Giá
Giá API Hunyuan3D
Giá tính theo từng kết quả đầu ra. Khoản phí cuối cùng thay đổi theo các tham số bạn đặt trong playground của từng biến thể (độ phân giải, thời lượng, số kết quả, tham chiếu).
| Endpoint | Loại | Giá khởi điểm |
|---|---|---|
| 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
Gọi API Hunyuan3D
Đăng ký API key tại wavespeed.ai/accesskey, rồi gửi prediction qua REST. Playground tạo sẵn mã mẫu có thể dán ngay cho mọi tổ hợp đầu vào.
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)So sánh
Hunyuan3D so với các lựa chọn khác
Khi nào nên chọn Hunyuan3D thay vì các mô hình tương tự trên WaveSpeedAI.
Hunyuan3D so với Tripo3D
Tripo3D có image-to-3D nhanh kèm bake texture. Hunyuan3D bao quát nhiều bậc chất lượng (Base, Mini, Multi-View, v2.1) từ nền tảng nghiên cứu của Tencent — chọn theo loại đầu vào (một hay nhiều góc nhìn) và nhu cầu độ trung thực.
Hunyuan3D so với Meshy
Meshy là công cụ tạo 3D ưu tiên web. Hunyuan3D ưu tiên API trên WaveSpeedAI — phù hợp hơn cho pipeline tự động, tạo tài sản hàng loạt và tích hợp SaaS mà không cần bước thao tác giao diện thủ công.
Hunyuan3D so với Manual photogrammetry
Photogrammetry cần hàng chục ảnh và thời gian xử lý dài. Hunyuan3D tạo mesh dùng được từ một hoặc vài ảnh trong vài giây — nhanh hơn cho tạo mẫu thử, kém chính xác hơn cho tái dựng cấp độ quét.
Câu hỏi thường gặp
Hunyuan3D API — Câu hỏi thường gặp
Giá, giấy phép, tích hợp — những câu hỏi phổ biến về việc chạy Hunyuan3D trên WaveSpeedAI.
API Hunyuan3D là gì?
Hunyuan3D là mô hình 3D của Tencent, được cung cấp dưới dạng REST API trên WaveSpeedAI. Tencent Hunyuan3D — tạo 3D từ ảnh, từ văn bản và từ phác thảo cho quy trình trực quan hóa và nội dung. Các biến thể V2 Base, Mini và Multi-View cùng các endpoint V3 Image-to-3D, Text-to-3D và Sketch-to-3D. Bạn có thể gọi bằng lập trình hoặc thử từ playground ở liên kết phía trên.
Làm sao để gọi API Hunyuan3D?
Đăng ký tài khoản WaveSpeedAI, sao chép API key từ /accesskey, rồi POST tới https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base với đầu vào dưới dạng JSON. Endpoint trả về prediction id. Hãy poll endpoint kết quả khoảng mỗi 2 giây, tăng khoảng cách với các tác vụ chạy lâu, và dừng ở bất kỳ trạng thái kết thúc nào. Ví dụ Python / Node.js / cURL hướng tới môi trường production ở phía trên.
API Hunyuan3D có giá bao nhiêu?
Hunyuan3D bắt đầu từ $0.12 mỗi lượt chạy. Chi phí chính xác thay đổi theo các tham số bạn đặt (độ phân giải, thời lượng, số kết quả, tham chiếu). Phần xem trước chi phí trực tiếp cạnh nút Tạo trong playground hiển thị giá chính xác cho đầu vào hiện tại của bạn.
Có những biến thể Hunyuan3D nào?
WaveSpeedAI cung cấp 7 endpoint Hunyuan3D đang hoạt động: 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. Mỗi biến thể có trang playground và giá riêng.
Tôi có thể dùng kết quả của Hunyuan3D cho mục đích thương mại không?
Quyền sử dụng thương mại tuân theo giấy phép mô hình của Tencent. Hầu hết mô hình của Tencent cho phép dùng kết quả đầu ra cho mục đích thương mại; hãy xem trang playground của từng mô hình để biết tóm tắt giấy phép cụ thể, và Điều khoản dịch vụ của WaveSpeedAI cho các điều kiện cấp nền tảng.
Tại sao dùng Hunyuan3D trên WaveSpeedAI thay vì gọi trực tiếp?
Một API key + một tài khoản thanh toán cho Hunyuan3D VÀ hơn 1.000 mô hình AI khác từ các nhà cung cấp khác. Không cần thiết lập SDK cho từng hãng, không có hạn mức tốc độ riêng, không phải viết lại mã tích hợp cho từng hãng. Giá thường ngang bằng hoặc thấp hơn API trực tiếp của Tencent.
Nhà cung cấp
Giới thiệu về Tencent
Đội ngũ đứng sau Hunyuan3D và dòng mô hình Tencent rộng hơn trên WaveSpeedAI.
Nhóm Hunyuan của Tencent tạo ra Hunyuan3D, dòng mô hình image-to-3D chuyển ảnh chụp thành mesh 3D cho trực quan hóa, tài sản game và thương mại điện tử. Các biến thể gồm tạo từ một ảnh, suy luận Mini nhẹ, tái dựng đa góc nhìn và hệ thống tạo tài sản có thể mở rộng v2.1.
Bắt đầu xây dựng với Hunyuan3D trên WaveSpeedAI
Tặng credit dùng thử miễn phí khi đăng ký. Một API key cho hơn 1.000 mô hình AI từ Tencent và mọi nhà cung cấp khác.