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

Download Results

下载提交到API的给定任务的结果。

上一页Check Status下一页Generate Texture

最后更新于9个月前

这有帮助吗?

在Check status端点返回的Done状态之后,调用这个API端点来获取生成任务的下载url。

在任务完成之前调用这个API端点可能会返回错误的结果,比如文件列表不完整。 查看了解如何查看任务是否完成。

价格

我们不会对调用API下载生成结果的行为收取任何额外的费用。

请求

Authentication

Authorization: Bearer RODIN_API_KEY

Body

API在POST请求体中需求一个参数。

Parameter
Type
Description

task_uuid

string

Required. 需要查询状态的任务UUID。通常,您将在生成API的响应中获得它。

响应

JSON响应包含以下字段。您可以在list列表中下载preview.webp以预览模型。

Property
Type
Description

error

string

可选。 可能存在的错误信息。

list

array

此任务可下载的模型文件列表。

list.url

string

下载模型文件的URL。

list.name

string

模型文件的名称。

样例

export RODIN_API_KEY="your api key"
curl -X 'POST' \
  'https://hyperhuman.deemos.com/api/v2/download' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "task_uuid": "your-task-uuid"
}'
unset RODIN_API_KEY
import requests

# Constants
ENDPOINT = "https://hyperhuman.deemos.com/api/v2/download"
API_KEY = "your api key"  # Replace with your actual API key
TASK_UUID = "your-task-uuid"  # Replace with your actual task UUID

# Prepare the headers
headers = {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {API_KEY}',
}

# Prepare the JSON payload
data = {
    "task_uuid": TASK_UUID
}

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

# Parse and return the JSON response
print(response.json())
{
  "list": [
    {
      "url": "https://example.com/",
      "name": "testfile"
    }
  ]
}

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

对于的task_uuid,使用uuid字段替代jobs_uuid。

Check Status
Quickstart section
  • POSTDownload result for a given task submitted to the API.
  • 价格
  • 请求
  • 响应
  • 样例

Download result for a given task submitted to the API.

post
授权
请求体
task_uuidstring必填
响应
201成功
application/json
post
POST /api/v2/download HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "task_uuid": "text"
}
201成功
{
  "error": "OK",
  "list": [
    {
      "url": "text",
      "name": "text"
    }
  ]
}
response from the Generation API