HI 3D 模型拆件

接口提示

mesh_url 必须是 HTTP 或 HTTPS URL。该模型为异步模型。

split_type=character 使用角色拆件参数，split_type=general 使用 level。两组参数不能混用。

认证

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

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

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

model string 必填

值：hi3d_model_split

mesh_url string 必填

输入 3D 模型的公开 HTTP 或 HTTPS URL。

split_type string

拆件流程。

可选值：character、general
默认值：character

format string

输出格式。

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

part string

角色拆件部位。

可选值：a、b、c、d、e、f

仅在 split_type=character 时使用，默认值为 a。

joint string

角色关节类型。

可选值：none、ball、dovetail、pin
默认值：ball

仅在 split_type=character 时使用。

merge string

是否合并选定关节。

可选值：yes、no
默认值：yes

仅在 split_type=character 且 joint 不为 none 时使用。joint=none 时不要传入 merge。

level string

通用拆件等级。

可选值：low、medium、high
默认值：medium

仅在 split_type=general 时使用，此模式下不要传入 part、joint 或 merge。

轮询

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

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

元数据信息