⌘K

HI 3D 模型多色

hi3d_model_multicolor

根据带纹理的 GLB 输入模型生成多色 3D 模型。

接口提示

mesh_url 必须指向带纹理的 GLB 模型，并且必须使用 HTTP 或 HTTPS。该模型为异步模型。

认证

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

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

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

model string 必填

值：hi3d_model_multicolor

mesh_url string 必填

带纹理 GLB 输入模型的公开 HTTP 或 HTTPS URL。

number_color integer

生成的颜色数量，范围为 0 到 8，默认值为 4。传入 0 时由模型自动确定颜色数量。

min_region_faces integer

颜色区域的最小面数。当 number_color 不为 0 时可传入正整数。

format string

输出格式。

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

该模型不支持 stl 和 usdz。

轮询

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

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

元数据信息