查询生成任务状态

POST

/domi/providers/hyper3d/api/v2/status

Hyper3D/Rodin 原协议透明转发。调用方使用 NewAPI AK，网关注入 Hyper3D Bearer Key。
生成接口返回的 uuid 用于下载，jobs.subscription_key 用于状态查询；两者含义不同，请勿混用。
当前仅开放状态查询和结果下载；创建接口在接入内部异步编排和 NewAPI 计费前不可用。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "subscription_key": "sub_abc123"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/hyper3d/api/v2/status' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "subscription_key": "sub_abc123"
}'

返回响应

🟢200

application/json

Hyper3D 子任务状态

Bodyapplication/json

示例

{
    "error": "OK",
    "jobs": [
        {
            "uuid": "job-uuid-1",
            "status": "Done"
        }
    ]
}

🟠400

🟠401

🟠4XX

🔴5XX

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

网格部件补全

获取生成结果下载地址