Bang!

The all in one API for generating Rodin.

post

The API for Bang a Rodin-generated Asset.

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

请求体

asset_idstring可选

strengthnumber可选Default: 5

geometry_file_formatstring · enum可选Default: glb可能的值:

materialstring · enum可选Default: PBR可能的值:

resolutionstring · enum可选Default: Basic可能的值:

requiredany可选

响应

201成功

application/json

post

/api/v2/bang

CLI

curl https://api.hyper3d.com/api/v2/bang \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--header 'Content-Type: multipart/form-data' \
--file 'asset_id=YOUR_UUID' \
--file "strength=5" \ 
--file "geometry_file_format=glb" \
--file "material=PBR" \
--file "resolution=Basic" \
...

201成功

{
  "error": "text",
  "message": "text",
  "uuid": "text",
  "jobs": {
    "uuids": [
      "text"
    ],
    "subscription_key": "text"
  }
}

Rodin BANG!

使用此API可将Rodin生成的资产分割为多个子模型。

注意：此节点只能使用由Rodin Gen-2生成的模型。

价格

基本费用：每次BANG 消耗0.5个积分。

请求

认证

此API使用Bearer密钥进行认证。所有请求必须在Authorization头中包含有效的令牌。

Authorization: Bearer RODIN_API_KEY

请求体

参数

类型

描述

asset_id

string

必填。Rodin Gen-2生成任务的UUID。

strength

number

可选，默认：5，范围2-12。此参数控制模型分割的强度。值越大，生成的碎片越多。

geometry_file_format

string

必填。生成的几何文件格式。支持的格式：glb、obj、fbx、stl、usdz。默认值：glb。

material

string

可选。材质类型。可能的值为PBR、Shaded、None和All。默认值为PBR。 PBR：基于物理的材质，包括基础颜色纹理、金属度纹理、法线纹理和粗糙度纹理，提供高真实感和动态光照下的物理准确性。 Shaded：仅包含烘焙光照的基础颜色纹理，提供风格化视觉效果。 None：无材质资产。 All：将同时提供PBR和Shaded两种材质。

resolution

string

可选。生成贴图资产的分辨率。可能的值为Basic、High。默认值为Basic。 Basic：2K分辨率。 High：4K分辨率。

响应

在请求检查状态和下载结果API端点时，请使用uuid字段而非jobs.uuids字段。

属性

类型

描述

error

string

错误信息（如有）。

message

string

成功消息或详细错误信息。

uuid

string

生成任务的唯一标识符。

jobs

object

任务对象，包含作为生成过程一部分执行的各个子任务的详细信息。

jobs.uuids

array of strings

子任务的UUID列表。

jobs.subscription_key

string

与这些任务关联的订阅密钥。

示例

export RODIN_API_KEY="your api key"
curl https://api.hyper3d.com/api/v2/bang \
  -H "Authorization: Bearer ${RODIN_API_KEY}" \
  -d "asset_id=YOUR_UUID" \
  -d "strength=5" \
  -d "geometry_file_format=glb" \
  -d "material=PBR" \
  -d "resolution=Basic" \
unset RODIN_API_KEY

import os
import requests

# 常量
ENDPOINT = "https://api.hyper3d.com/api/v2/bang"
API_KEY = "your api key"  # 替换为您的实际API密钥
UUID = "Your_UUID"  # 替换为您的Rodin Gen-2生成任务的UUID

# 准备表单数据
data = {
    'asset_id': UUID,
    'strength': 5, 
    'geometry_file_format': 'glb',
    'material': 'PBR',
    'resolution': 'Basic',
}

# 准备请求头
headers = {
    'Authorization': f'Bearer {API_KEY}',
}

# 发送POST请求
response = requests.post(ENDPOINT, data=data, headers=headers)

# 检查请求是否成功
if response.status_code == 200:
    # 解析并打印JSON响应
    result = response.json()
    print("成功！任务已提交：")
    print(f"任务UUID: {result.get('uuid')}")
else:
    print(f"错误: {response.status_code}")
    print(response.text)

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

上一页Gen-1&1.5 Generation 下一页Check Balance

最后更新于10天前

这有帮助吗？