Hyper3D API Documentation
控制台登陆开始使用
简体中文
简体中文
  • GET STARTED
    • Get started with Rodin
    • Minimal Example
  • API Specification
    • Overview
    • Rodin Generation
    • Check Balance
    • Check Status
    • Download Results
    • Generate Texture
  • OTHER
    • Data Policy
由 GitBook 提供支持
在本页

这有帮助吗?

  1. API Specification

Generate Texture

上一页Download Results下一页Data Policy

最后更新于4个月前

这有帮助吗?

贴图生成

贴图生成

价格

每次调用该API生成需要消耗 0.5 credits。

Request

Note: 所有到这个端点的请求都必须使用multipart/form-data发送,以正确处理文件上传以及网格和纹理生成过程所需的其他参数。

Authentication

Authorization: Bearer RODIN_API_KEY

Body

参数
类型
描述

image

file/Binary

必须. 上传一张图片文件作为生成贴图的图片参考。

prompt

string

可选的。一段描述贴图的文字,指导贴图生成。

model

file/Binary

必须. 上传一个二进制的三维模型文件进行处理。

seed

number

可选的。网格生成中用于随机化的种子值,范围从0到65535(包括两者)。如果不提供,种子将随机生成。

reference_scale

number

可选的。表示纹理生成过程中的参考尺寸。

geometry_file_format

string

可选的。模型文件的格式。可能的值为glb,usdz,fbx,obj,stl。默认值为glb。

material

string

可选的。材质类型。可能的值为PBR和Shaded。默认值为PBR。

resolution

string

可选的。 输出贴图的分辨率。可能的值为Basic 和 High. 默认是Basic.

样例

export RODIN_API_KEY="your api key"
curl https://hyperhuman.deemos.com/api/v2/rodin_texture_only \
  -H "Authorization: Bearer ${RODIN_API_KEY}" \
  -F "image=@/path/to/your/image.jpg" \
  -F "model=@path/to/your/model.obj"  \
  -F "reference_scale=1.0" \
  -F "geometry_file_format=glb" \
  -F "material=PBR" \
  -F "resolution=High"
unset RODIN_API_KEY
import requests

# Constants
ENDPOINT = "https://hyperhuman.deemos.com/api/v2/rodin_texture_only"
API_KEY = "your api key"  # Replace with your actual API key
IMAGE_PATH = "/path/to/your/image.jpg"  # Replace with the path to your image
MODEL_PATH = "/path/to/your/model.obj"

# Prepare the headers
headers = {
    'Authorization': f'Bearer {API_KEY}',
}

# Prepare the form data
files = {
    'image': (os.path.basename(IMAGE_PATH), image_data, 'image/jpeg'),
    'model': (os.path.basename(MODEL_PATH), model_data, 'model/obj'),
    'reference_scale': (None, 1.0),
    'geometry_file_format': (None, 'glb'),
    'material': (None, PBR),
    'resolution': (None, 'High'),
}

# Make the POST request
response = requests.post(ENDPOINT, headers=headers, files=files)

# Parse and return the JSON response
print(response.json())
{
  "error": null,
  "message": "Submitted.",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "jobs": {
      "uuids": ["job-uuid-1", "job-uuid-2"],
      "subscription_key": "sub-key-1"
  }
}

使用此API向我们的服务器提交异步任务。你将从API中获得一个任务UUID,该UUID可用于和。

此API使用密钥进行身份验证。您需要在所有请求的Authorization头中包含一个有效的密钥. 参阅获取您的账户的API生成密钥。

检查进度
下载结果
  • 贴图生成
  • POSTThis API will generate textures and 3D model for the given images, prompt and 3D model.
  • 贴图生成

This API will generate textures and 3D model for the given images, prompt and 3D model.

post
授权
请求体
imagestring · binary必填
promptstring可选
modelbinary必填
seednumber可选
geometry_file_formatstring · enum可选Default: glb可能的值:
materialstring · enum可选Default: PBR可能的值:
escorenumber可选Default: 3.5
reference_scalenumber可选Default: 1
resolutionstring · enum可选Default: Basic可能的值:
响应
201成功
application/json
post
POST /api/v2/rodin_texture_only HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 156

{
  "image": "binary",
  "prompt": "text",
  "model": null,
  "seed": 1,
  "geometry_file_format": "glb",
  "material": "PBR",
  "escore": 3.5,
  "reference_scale": 1,
  "resolution": "Basic"
}
201成功
{
  "error": "text",
  "message": "text",
  "uuid": "text",
  "submit_time": null,
  "jobs": {
    "uuids": [
      "text"
    ],
    "subscription_key": "text"
  }
}
快速开始