创建 BANG 模型拆件任务

POST

/domi/providers/hyper3d/api/v2/bang

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

当前网关支持的模型：bang（网关标识 hyper3d-bang），由接口固定绑定，无需传模型名称。multipart 的 model 字段表示上传的 3D 文件，不是模型名称。列表依据仓库 SQL 配置，实际可用性取决于部署环境启用配置及 NewAPI 授权。

当前价格基线为 $8/12 Credits、USD/CNY=6.8；每次 0.5 Credit（¥2.26666667）。

请求参数

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/hyper3d/api/v2/bang' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--form 'asset_id="rodin-task-uuid"' \
--form 'model=@""' \
--form 'image=@""' \
--form 'prompt="painted wooden toy"'

返回响应

🟢200

application/json

Hyper3D 任务已提交

Bodyapplication/json

示例

{
    "error": null,
    "message": "Submitted.",
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "jobs": {
        "uuids": [
            "job-uuid-1"
        ],
        "subscription_key": "sub-key-1"
    }
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-09-16 09:19:31

创建 Rodin 模型生成任务

创建单独纹理生成任务