获取生成结果下载地址

POST

/domi/providers/hyper3d/api/v2/download

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必填

示例

{
    "task_uuid": "018f8400-8162-7e03-ba2d-a28a95ba4a34"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/hyper3d/api/v2/download' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "task_uuid": "018f8400-8162-7e03-ba2d-a28a95ba4a34"
}'

返回响应

🟢200

application/json

可下载的生成结果文件

Bodyapplication/json

示例

{
    "list": [
        {
            "url": "https://cdn.example.com/model.glb",
            "name": "model.glb"
        },
        {
            "url": "https://cdn.example.com/preview.webp",
            "name": "preview.webp"
        }
    ]
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-08-12 06:31:17

查询生成任务状态

分页查询可打印性分析任务