Nano Banana 2.1 现已上线 — Google 最新模型 | 立即体验 →
Tencent3D API$0.12/次起

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 示例输出

概览

关于 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 端点——请选择适合你工作流的变体。

image-to-3dHunyuan3d v3 Sketch To 3d — Tencent 的 Hunyuan3D image-to-3d 预览

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.

$0.45 起
image-to-3dHunyuan3d v3 Image To 3d — Tencent 的 Hunyuan3D image-to-3d 预览

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.

$0.30 起
text-to-3dHunyuan3d v3 Text To 3d — Tencent 的 Hunyuan3D text-to-3d 预览

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.

$0.30 起
image-to-3dHunyuan3d v2.1 — Tencent 的 Hunyuan3D image-to-3d 预览

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.

$0.45 起
image-to-3dHunyuan3d v2 Multi View — Tencent 的 Hunyuan3D image-to-3d 预览

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.

$0.20 起
image-to-3dHunyuan3d v2 Mini — Tencent 的 Hunyuan3D image-to-3d 预览

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.

$0.12 起
image-to-3dHunyuan3d v2 Base — Tencent 的 Hunyuan3D image-to-3d 预览

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.

$0.16 起

示例

看看 Hunyuan3D 的实际效果

由 Hunyuan3D API 生成的真实输出。悬停在任意视频上即可预览,点击可打开全尺寸查看器。

使用方法

如何使用 Hunyuan3D API

从注册到完成一次生成,只需四步。完整的 Python、Node.js 和 cURL 示例见下方的 API 部分。

  1. 01

    获取 API 密钥

    注册 WaveSpeedAI 账号,并从控制台复制你的 API 密钥。新账号附带免费体验额度——足够在开始计费前把 Playground 运行几十次。

  2. 02

    提交预测

    把你的输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base。端点会立即返回预测 ID——生成是异步的,因此推理期间你无需保持连接。

  3. 03

    轮询完成状态

    GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。状态为 completed 时返回输出;状态为 failed、cancelled、timeout 或 deleted 时以错误终止;其他任何状态都继续轮询。

  4. 04

    读取输出 URL

    状态变为 "completed" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 Hunyuan3D 变体。

应用场景

用 Hunyuan3D 可以构建什么

开发者和创作者使用 Hunyuan3D API 的常见工作流。

01

单张图像生成 3D 资产

wavespeed-ai/hunyuan3d/v2-base 是腾讯推出的最先进的图生 3D 模型,把图像转换为用于可视化和内容的 3D 资产——是产品和角色网格生成的默认端点。

image-to-3dbasemesh
02

轻量的 Mini 变体

wavespeed-ai/hunyuan3d/v2-mini 是腾讯紧凑的图生 3D 生成模型——适合快速迭代、移动端预览,以及网格细节可在下游再精修的流水线。

minifastiteration
03

多视角重建

wavespeed-ai/hunyuan3d/v2-multi-view 根据多张图像生成精确的 3D 重建——提供正面、侧面和背面视图,可让被遮挡表面的几何更可靠。

multi-viewreconstructiongeometry
04

v2.1 可扩展的资产创建

wavespeed-ai/hunyuan3d/v2.1 是腾讯可扩展的 3D 资产创建系统,推进了 3D 生成的最新水平——适用于需要更高保真度的生产级资产工作流。

v2.1productionfidelity
05

V3 提示词生成 3D

wavespeed-ai/hunyuan3d-v3/text-to-3d 把文本提示词变成细致、完整贴图的 3D 模型——无需源图像,仅凭描述即可生成资产。

text-to-3dv3textured
06

V3 草图生成 3D,用于概念图

wavespeed-ai/hunyuan3d-v3/sketch-to-3d 把手绘草图和概念图转换为细致的 3D 模型——适合早期的设计探索。

sketch-to-3dconceptv3

技巧

Hunyuan3D 提示词技巧

让 Hunyuan3D 输出更好结果的实用建议——总结自生产流水线中各类3D模型都适用的做法。

  1. 01

    被遮挡的几何结构使用多视角

    当您有正面、侧面和背面照片时,请使用 v2-multi-view——单图的 Base/Mini 对被遮挡的表面只能靠猜测,而多视角则能准确重建。

  2. 02

    Mini 用于快速迭代

    概念探索阶段用 v2-mini 快速生成预览网格;几何方向确定后再切换到 v2-base 或 v2.1。

  3. 03

    使用干净、光线良好的源图像

    图生 3D 的质量受限于源照片的质量。均匀的光线、尽量少的阴影和清晰的主体轮廓,能得到更干净的网格。

  4. 04

    在下游明确 PBR 预期

    Hunyuan3D 输出用于可视化的网格——请计划在生成之后,在您的 DCC 工具或渲染引擎中完成贴图和 PBR 材质处理。

  5. 05

    在中性背景上拍摄产品照片

    白色/中性背景的电商产品图,能得到最干净的几何提取——杂乱的背景会给重建的网格增加噪点。

定价

Hunyuan3D API 定价

按输出计费。最终费用会随你在各变体 Playground 中设置的参数(分辨率、时长、输出数量、参考素材)而变化。

起步价

$0.12/ 次

7 个端点 · Hunyuan3D

打开 Playground

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
done

对比

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 模型。