获取生成结果下载地址

POST

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

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

示例

{
    "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-07-28 04:34:48

查询生成任务状态

分页查询 Text to 3D 任务