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 密钥调用多个变体,组合成多步骤流水线。
使用与 WaveSpeedAI 上其他 1,000 多个 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
提交预测
把你的输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base。端点会立即返回预测 ID——生成是异步的,因此推理期间你无需保持连接。
- 03
轮询完成状态
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。状态为 completed 时返回输出;状态为 failed、cancelled、timeout 或 deleted 时以错误终止;其他任何状态都继续轮询。
- 04
读取输出 URL
状态变为 "completed" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 Hunyuan3D 变体。
应用场景
用 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 提交预测。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 对比 Tripo3D
Tripo3D 提供带纹理烘焙的快速图生 3D。Hunyuan3D 来自腾讯的研究体系,涵盖多个质量档位(Base、Mini、Multi-View、v2.1)——请根据输入类型(单视角或多视角)和保真度需求来选择。
Hunyuan3D 对比 Meshy
Meshy 是以网页为先的 3D 生成工具。Hunyuan3D 在 WaveSpeedAI 上以 API 为先——更适合自动化流水线、批量资产生成和 SaaS 集成,无需手动操作界面。
Hunyuan3D 对比 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。端点会返回预测 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 及 WaveSpeedAI 上 Tencent 更多模型背后的团队。
腾讯混元团队推出了 Hunyuan3D,这是一系列图生 3D 模型,可将照片转换为 3D 网格,用于可视化、游戏资产和电商。变体涵盖单图生成、轻量的 Mini 推理、多视角重建以及 v2.1 可扩展资产创建系统。
在 WaveSpeedAI 上用 Hunyuan3D 开始构建
注册即送免费体验额度。一个 API 密钥,即可使用来自 Tencent 及其他所有提供方的 1,000 多个 AI 模型。