创建 Rodin 模型生成任务

POST

/domi/providers/hyper3d/api/v2/rodin

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

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

当前价格基线为 $8/12 Credits、USD/CNY=6.8。基础档 0.5 Credit（¥2.26666667）；Gen-2.5-Extreme-High 为 1 Credit（¥4.53333333）；HighPack 额外增加 1 Credit。

请求参数

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/rodin' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--form 'images="(binary)"' \
--form 'prompt="a ceramic robot"' \
--form 'tier="Gen-2.5-Medium"' \
--form 'geometry_file_format="glb"' \
--form 'material="PBR"' \
--form 'mesh_mode="Raw"' \
--form 'quality="medium"' \
--form 'addons="HighPack"' \
--form 'TAPose="false"' \
--form 'preview_render="false"' \
--form 'hd_texture="false"'

返回响应

🟢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

网格部件补全

创建 BANG 模型拆件任务