创建 3D 模型修改任务

POST

/domi/providers/hyper3d/api/v2/edit

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

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

网关当前计费配置为 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/edit' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--form 'asset_id="rodin-task-uuid"' \
--form 'model=@"(binary)"' \
--form 'image="(binary)"' \
--form 'reference_bbox="[-0.5,-1.0,0.0,0.5,0.0,1.0]"' \
--form 'prompt="add a backpack"' \
--form 'mesh_mode="Quad"' \
--form 'face_count="50000"' \
--form 'geometry_file_format="glb"' \
--form 'material="PBR"' \
--form 'resolution="Basic"' \
--form 'lowres_texture="false"' \
--form 'hd_texture="false"' \
--form 'model_early_export="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

创建单独纹理生成任务

查询生成任务状态