查询生成任务状态

POST

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

Hyper3D/Rodin 原协议透明转发。调用方使用 NewAPI AK，网关注入 Hyper3D Bearer Key。
生成接口返回的 uuid 用于下载，jobs.subscription_key 用于状态查询；两者含义不同，请勿混用。
Rodin、BANG、模型修改和单独纹理任务由网关持久化轮询；全部子任务 Done 且下载结果已保存后才触发 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-08-12 06:31:17

创建 3D 模型修改任务

获取生成结果下载地址