接口提示
tencent_hunyuan_3d_rapid_intl 的 prompt、image_url 和 image_base64 三者只能三选一作为主输入
tencent_hunyuan_3d_rapid_intl 提供 enable_pbr、result_format 和 enable_geometry 作为可选生成控制参数
tencent_hunyuan_3d_rapid_intl 在 params 中不提供 face_count、generate_type、polygon_type、multi_view_images 或上游 model 选择
认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: tencent_hunyuan_3d_rapid_intl
prompt string
文生 3D 提示词. prompt、image_url 和 image_base64 三者只能三选一
最大长度: 200 个 UTF-8 字符
image_base64 string
Base64 编码的输入图片. prompt、image_url 和 image_base64 三者只能三选一
支持格式: jpg, png, jpeg, webp
分辨率: 单边需在 128 到 5000 像素之间
image_url string
公开可访问的输入图片 URL. prompt、image_url 和 image_base64 三者只能三选一
支持格式: jpg, png, jpeg, webp
分辨率: 单边需在 128 到 5000 像素之间
result_format string
生成 3D 资产或预览输出的目标导出格式
可选值: OBJ, GLB, STL, USDZ, FBX, MP4
enable_pbr boolean
是否为输出资产生成 PBR 材质
可选值: true, false
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
string错误码
message
string详细错误信息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成的资源内容列表
type
string资源类型
值:
image｜videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 13003095 | 上游内部生成错误 |
| 13003096 | 结果解析异常 |
| 13003097 | 上游 HTTP 响应错误 |
| 13003098 | 任务状态查询异常 |
| 13003099 | 上游任务创建异常 |