混元生3D专业版

正式环境

https://api.302.ai

POST

/tencent/hunyuan3d/pro-job

基于混元大模型，根据输入的文本描述/图片智能生成3D模型。

默认提供3个并发，代表最多能同时处理3个已提交的任务；上一个任务处理完毕后，方可开始处理下一个任务。

调用接口时，不同参数组合对应不同扣费标准，默认模式为文/图生3D+普通贴图模式，一次消耗0.4 PTC。
✅ 生成失败的任务不扣除任何费用（含内容风控策略导致的失败，任何失败原因均适用）。

生成任务类型
GenerateType为必选参数，默认值为Normal；可从4种生成模式中任选1种，费用按对应类型扣除。

生成任务类型	功能描述	消耗费用
Normal	生成带纹理的几何模型	0.4 PTC/次
LowPoly	生成智能减面后带纹理的几何模型	0.5 PTC/次
Geometry	生成不带纹理的几何模型（白模）	0.3 PTC/次
Sketch	输入草图/线稿图生成带纹理的几何模型	0.5 PTC/次

附加参数
选择生成任务类型后可附加使用，参数支持多选，费用按附加项叠加扣除。

附加参数名	功能描述	额外消耗费用
MultiViewImages	通过多视图生成3D模型	0.2 PTC/次
EnablePBR	生成带PBR材质的3D模型，含金属度、粗糙度、法线贴图	0.2 PTC/次
FaceCount	生成自定义面数的3D模型	0.2 PTC/次
ResultFormat	自定义生成模型的格式	0.1 PTC/次

关键参数规则

三选一必填：ImageBase64、ImageUrl、Prompt三者必填其一，且Prompt不可与ImageBase64/ImageUrl同时存在（Sketch模式除外）；

版本限制：3.1版本不支持LowPoly参数，仅3.1版本支持顶/底/斜前视角；

参数生效：Geometry模式下EnablePBR参数不生效，PolygonType仅LowPoly模式下生效。

请求参数

Header 参数

Body 参数application/json

示例

{
  "Prompt": "一只小猫"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/tencent/hunyuan3d/pro-job' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "Prompt": "一只小猫"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "Response": {
        "JobId": "1407969018996203520",
        "RequestId": "98ea38ef-48b6-4a45-ab04-9dab730d4994"
    }
}

修改于 2026-01-28 10:25:19

Hunyuan3d-v21（获取任务结果）

混元生3D专业版（获取）