01
hunyuan-3d/v3.1/pro/image-to-3d
将正面物体图片转换为 3D 资产，并可使用 PBR、几何模式、自定义面数和额外视角图片。
Examples
定价详情
透明定价，无隐藏费用。按量付费，用多少付多少。
hunyuan-3d/v3.1/pro/text-to-3dBase generation
PoYo价格
$0.300/次
60 积分
官方价格
$0.375/次
Official
为你节省
20%
hunyuan-3d/v3.1/pro/image-to-3dBase generation
PoYo价格
$0.300/次
60 积分
官方价格
$0.375/次
Official
为你节省
20%
hunyuan-3d/v3.1/rapid/text-to-3dBase generation
PoYo价格
$0.180/次
36 积分
官方价格
$0.225/次
Official
为你节省
20%
hunyuan-3d/v3.1/rapid/image-to-3dBase generation
PoYo价格
$0.180/次
36 积分
官方价格
$0.225/次
Official
为你节省
20%
hunyuan-3d/v3.1/pro/image-to-3dPBR add-on
PoYo价格
$0.120
24 积分
官方价格
$0.150
Official
为你节省
20%
hunyuan-3d/v3.1/pro/image-to-3dMulti-view add-on
PoYo价格
$0.120
24 积分
官方价格
$0.150
Official
为你节省
20%
hunyuan-3d/v3.1/pro/text-to-3dCustom face count add-on
PoYo价格
$0.120
24 积分
官方价格
$0.150
Official
为你节省
20%
| 型号 | 规格 | PoYo价格 | 官方价格 | 为你节省 |
|---|---|---|---|---|
| hunyuan-3d/v3.1/pro/text-to-3d | Base generation | $0.300/次 60 积分 /次 | $0.375/次 Official | 20% |
Custom face count add-on | $0.120 24 积分 additional | $0.150 Official | 20% | |
| hunyuan-3d/v3.1/pro/image-to-3d | Base generation | $0.300/次 60 积分 /次 | $0.375/次 Official | 20% |
PBR add-on | $0.120 24 积分 additional | $0.150 Official | 20% | |
Multi-view add-on | $0.120 24 积分 additional | $0.150 Official | 20% | |
| hunyuan-3d/v3.1/rapid/text-to-3d | Base generation | $0.180/次 36 积分 /次 | $0.225/次 Official | 20% |
| hunyuan-3d/v3.1/rapid/image-to-3d | Base generation | $0.180/次 36 积分 /次 | $0.225/次 Official | 20% |
* 实际费用以最终输出为准。
介绍
使用 Hunyuan 3D v3.1 API 的完整指南
Hunyuan 3D v3.1 API
PoYo.ai 提供四个 Hunyuan 3D v3.1 模型，支持统一提交任务、轮询状态、回调通知，并在生成完成后下载 3D 输出文件。
可用模型
获取 API Key
02
hunyuan-3d/v3.1/pro/text-to-3d
用更长的文本提示词生成 3D 资产，并支持 PBR、几何模式和自定义面数。
03
hunyuan-3d/v3.1/rapid/text-to-3d
用较短提示词快速生成 3D 草稿，适合低成本探索。
04
hunyuan-3d/v3.1/rapid/image-to-3d
用单张物体图片快速生成 3D 模型，适合快速预览和迭代。
Hunyuan 3D v3.1 API 的核心能力
选择 Pro 或 Rapid 模型，覆盖 text-to-3D 与 image-to-3D，并使用 PoYo 当前开放的控制项。
01
Pro 图生 3D 与多视角参考
上传一张正面物体图片；如果有更多参考，也可以补充侧面、背面、顶部、底部或斜向视角。Pro 图生 3D 还支持 PBR、几何模式和自定义面数。
- 正面图片通过 PoYo image_urls 提交
- Pro 图生 3D 支持可选多视角字段
- 需要时可启用 PBR 与自定义面数
02
Pro 文生 3D 适合详细提示词
当物体造型、材质方向和概念说明主要来自文字时，使用 Pro text-to-3D。PoYo 保持异步 API 流程一致，便于轮询状态和接收回调。
- 支持更长提示词
- 可选 PBR、几何模式和面数
- 统一状态查询和文件获取
03
Rapid 文生 3D 用于快速草稿
Rapid text-to-3D 适合早期创意、物体探索和低成本草稿生成。它适合用较短提示词快速比较多个方向，再决定是否进入 Pro 模型或手工优化。
- 基础成本低于 Pro
- 未选择几何模式时可启用 PBR
- 适合资产探索和迭代
04
Rapid 图生 3D 使用单张参考图
已有产品、道具、草图或物体参考时，可用 Rapid 图生 3D 快速获得 3D 结果。PoYo 接收简单的 image_urls 输入，并返回统一的任务结果。
- 单张图片作为输入
- 按支持情况使用 PBR 或几何选项
- 返回缩略图和模型文件
使用场景
01
游戏道具构思
从提示词或物体参考生成早期道具概念，减少手工建模前的探索成本。
02
产品与物体可视化
把正面图或多视角参考转换为可评审、可下载的 3D 输出。
03
3D 资产批量探索
在同一 API 格式下比较 Pro 和 Rapid 结果，并保持价格、状态和文件获取一致。
04
异步 3D 生成管线
通过回调或轮询提交 Hunyuan 3D 任务，并把完成后的模型文件接入生产工具。
Hunyuan 3D v3.1 Pro 与 Rapid 对比
PoYo 当前开放的四个 Hunyuan 3D v3.1 模型的高层对比。
| 能力 | Pro | Rapid |
|---|---|---|
| 输入模型 | Text-to-3D 与 image-to-3D | Text-to-3D 与 image-to-3D |
| 适合场景 | 需要 PBR、几何模式、面数或多视角参考的高控制任务 | 从提示词或单张图片快速低成本试稿 |
| 提示词长度 | 最长 1024 字符 | 最长 200 字符 |
| 图像控制 | 正面图加 Pro 图生 3D 的额外视角 URL | 单张正面图输入 |
| 计费方式 | 基础生成加可选附加项 | 基础生成加可选 PBR 附加项 |
实际可用输出取决于所选模型和返回文件。
如何在 PoYo 使用 Hunyuan 3D v3.1 API
步骤 1：创建 API Key
注册 PoYo 并在控制台创建 API Key。
创建 API Key ->
步骤 2：选择 Hunyuan 3D v3.1 模型
从 Pro image、Pro text、Rapid text、Rapid image 四个公开模型 ID 中选择一个。
步骤 3：提交 PoYo 入参
文本模型使用 prompt，图像模型使用 image_urls。仅在所选模型支持时添加 PBR、几何、面数或多视角字段。
步骤 4：获取生成资产
轮询任务状态或提供 callback URL，任务完成后下载返回的 GLB、OBJ、MTL、贴图、缩略图或模型 URL 文件。
查看文档 ->
Hunyuan 3D v3.1 API 价格
Hunyuan 3D v3.1 在 PoYo 按次生成计费，并根据可选功能产生附加费用。
Pro 模型和 Rapid 模型使用不同基础价格；PBR、多视角输入和自定义面数等可选能力会在支持的模型上额外计费。
充值积分并开始测试 Hunyuan 3D v3.1。 充值积分 ->
常见问题
应该选择哪个 Hunyuan 3D v3.1 模型？
需要 PBR、几何模式、自定义面数或多视角图片参考时选择 Pro；需要低成本快速草稿时选择 Rapid。
PoYo 上的图像输入如何传？
图像模型使用 image_urls，数组中放一个正面图片 URL。PoYo 在 Hunyuan 3D 图像模型中保持一致的输入格式。
可以使用多视角图片吗？
可以，但仅限 hunyuan-3d/v3.1/pro/image-to-3d。可选字段包括背面、左侧、右侧、顶部、底部、左前和右前图片 URL。
API 会返回哪些文件？
根据模型不同，结果可能包含 GLB、OBJ、MTL、贴图、缩略图和模型 URL 集合。
为什么使用 PoYo.ai
01
统一异步 3D API
四个 Hunyuan 3D v3.1 模型使用相同的提交、状态、回调和文件获取方式。
02
透明积分计费
提交前即可看到基础生成和附加能力的预估积分。
03
模型专属控制项
Playground 只展示当前 Pro 或 Rapid 模型支持的控制项。
04
统一输出文件
PoYo 将返回的模型、贴图和缩略图整理为一致的任务结果格式。