Tencent Hunyuan 3D

接口提示

tencent_hunyuan_3d 的 prompt、image_url 和 image_base64 三者只能三选一作为主输入

tencent_hunyuan_3d 支持通过 multi_view_images 提供多视角引导, 子项应使用 View 搭配 ImageUrl 或 ImageBase64

tencent_hunyuan_3d 的 multi_view_images 仅支持 left、right 和 back 三种 View 取值

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

值: tencent_hunyuan_3d

---

prompt string

文生 3D 提示词. prompt、image_url 和 image_base64 三者只能三选一

最大长度: 1024 个 UTF-8 字符

---

image_base64 string

Base64 编码的输入图片. prompt、image_url 和 image_base64 三者只能三选一

支持格式: jpg, png, jpeg, webp
图片大小: 不超过 8MB
分辨率: 单边需在 128 到 5000 像素之间

---

image_url string

公开可访问的输入图片 URL. prompt、image_url 和 image_base64 三者只能三选一

支持格式: jpg, png, jpeg, webp
图片大小: 不超过 8MB
分辨率: 单边需在 128 到 5000 像素之间

---

result_format string

生成 3D 资产或预览输出的目标导出格式

可选值: OBJ, GLB, STL, USDZ, FBX, MP4

---

enable_pbr boolean

是否为输出资产生成 PBR 材质

可选值: true, false

---

multi_view_images array

用于增强几何一致性的可选多视角参考图列表. 每个子项都必须包含 View 以及 ImageUrl 或 ImageBase64 其中之一

支持视角: left, right, back

item object

单个多视角参考图对象

View string 必填

当前参考图对应的视角标识

可选值: left, right, back

ImageUrl string

当前视角图片的公开可访问 URL

ImageBase64 string

当前视角图片的 Base64 编码内容

---

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

---

响应格式

error object

错误信息, 仅在状态为 failed 时存在

code string

错误码

message string

详细错误信息

---

output array

生成结果, 仅在状态为 completed 时存在

content array

生成的资源内容列表

type string

资源类型

值: image｜video

url string

处理后的资源 URL

jobId string

远端任务 ID

---

usage object

使用统计, 仅在状态为 completed 时存在

cost string

总费用（美元）

discount number

折扣金额

---

metadata object

元数据信息

---

错误码

错误码	描述
13002095	上游内部生成错误
13002096	结果解析异常
13002097	上游 HTTP 响应错误
13002098	任务状态查询异常
13002099	上游任务创建异常