HI 3D 图生 3D

接口提示

hi3d_image_to_3d 的 image、image_url 和 image_base64 必须三选一。

该模型为异步模型，需要先提交任务，再轮询任务 ID 直到任务结束。

认证

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

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

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

model string 必填

请求使用的模型 ID。

值：hi3d_image_to_3d

image string

输入图片。image、image_url 和 image_base64 必须三选一。

image_url string

公开可访问的输入图片 URL。支持 PNG、JPEG 和 WebP。

image_base64 string

Base64 编码的输入图片。支持 PNG、JPEG 和 WebP。

model_version string

HI 3D 模型版本。

可选值：hitem3dv1.5、hitem3dv2.0、hitem3dv2.1、hi3dv3.0
默认值：hi3dv3.0

request_type integer

输出模式：1 表示纯几何，3 表示几何加纹理。

默认值：3

resolution string

输出分辨率。可选值取决于 model_version：512、1024、1536、1536pro、1536fast、2048quality 或 2048master。

hi3dv3.0 默认使用 2048quality。

pbr integer

是否生成 PBR 材质。

可选值：0、1
默认值：1

rmbg integer

是否移除图片背景。

可选值：0、1
默认值：1

face integer

目标面数，范围为 100000 到 5000000。

shading number

明暗值，范围为 0 到 1，默认值为 0.5。

format string

输出文件格式。

可选值：obj、glb、stl、fbx、usdz、3mf
默认值：glb

使用 hitem3dv1.5 或纯几何输出时，部分 PBR 参数不会生效。

轮询

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

初始响应只返回任务 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

元数据信息