下载结果

使用生成响应顶层的 uuid 获取可下载文件列表。

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

task_uuid*string

生成响应顶层 uuid 返回的任务标识。

Response Body

`application/json`

curl -X POST "https://example.com/api/v2/download" \  -H "Content-Type: application/json" \  -d '{    "task_uuid": "123e4567-e89b-12d3-a456-426614174000"  }'

{  "error": "NO_SUCH_TASK",  "list": [    {      "url": "string",      "name": "string"    }  ]}

标识选择

把生成响应顶层的 uuid 作为 task_uuid 提交。它与查询状态所用的 jobs.subscription_key 不同。

示例

curl --fail-with-body --request POST 'https://api.hyper3d.com/api/v2/download' \
  --header "Authorization: Bearer ${RODIN_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"task_uuid":"123e4567-e89b-12d3-a456-426614174000"}'

import os

import requests

api_key = os.environ["RODIN_API_KEY"]
response = requests.post(
    "https://api.hyper3d.com/api/v2/download",
    headers={"Authorization": f"Bearer {api_key}"},
    json={"task_uuid": "123e4567-e89b-12d3-a456-426614174000"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

响应

{
  "list": [
    {
      "name": "model.glb",
      "url": "https://example.invalid/download/model.glb"
    }
  ]
}

可用性与错误

仅在所有 job 都为 Done 后调用此接口；该 endpoint 不承诺拒绝尚未完成的任务。HTTP 201 返回当前可用文件，400 表示请求无效，401 表示鉴权无效，429 表示触发限流。下载链接可能过期，应及时下载文件，不要长期保存链接。