创建图生 3D 浮雕任务

POST

/domi/providers/hi3d/open-api/v1/depth/create-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/depth/create-task' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--form 'image=@"(binary)"' \
--form 'image_url="https://example.com/logo.png"' \
--form 'model_type="pro"' \
--form 'rmbg="1"' \
--form 'response_format="url"' \
--form 'format="2"' \
--form 'callback_url="https://example.com/webhooks/hi3d"'

返回响应

🟢200

application/json

Hi3D 创建任务成功响应

Bodyapplication/json

示例

{
    "code": 200,
    "data": {
        "task_id": "depth_20260312_8f92ab3e1cde"
    },
    "msg": "success"
}

🟠400

🟠401

🟠4XX

🔴5XX

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

查询图生 3D 任务

查询图生 3D 浮雕任务