创建图生 3D 任务

POST

/domi/providers/hi3d/open-api/v1/submit-task

Hi3D 原协议透明转发。公开地址为 /domi/providers/hi3d + Hi3D 原始路径。
调用方提供 NewAPI AK；网关内部换取并缓存 Hi3D access token，因此不暴露 /auth/token。
请求方法、query、multipart 字段和供应商响应保持原样。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/hi3d/open-api/v1/submit-task' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--form 'request_type="3"' \
--form 'model="hitem3dv2.1"' \
--form 'images=@"(binary)"' \
--form 'multi_images=""' \
--form 'multi_images_bit="1010"' \
--form 'mesh=@""' \
--form 'mesh_url="https://example.com/model.glb"' \
--form 'resolution="1536fast"' \
--form 'pbr="1"' \
--form 'face="1000000"' \
--form 'format="2"' \
--form 'callback_url="https://example.com/webhooks/hi3d"'

返回响应

🟢200

application/json

Hi3D 创建任务成功响应

Bodyapplication/json

示例

{
    "code": 200,
    "data": {
        "task_id": "528f172b66554be2a2d1e95db4454a5a.jjewelry-aigc-api.7qbh5Z0wfR"
    },
    "msg": "success"
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-07-28 04:34:48

参数说明（非接口请求）：domi-ai-metadata 业务元数据

查询图生 3D 任务