API 规范
下载结果
全部 job 完成后获取带签名的下载链接。
POST
bearerheader
AuthorizationBearer <token>application/json- body
task_uuid*string生成响应顶层 uuid 返回的任务标识。
Format
uuidapplication/json- response
error?string错误码，当请求无法提交时返回。该字段会随 HTTP 201 一起在响应体中返回，因此客户端必须检查此字段，而不能仅依赖 HTTP 状态码。成功时省略此字段。错误码详细请参考 [errors](/zh/api-specification/errors)。
Value in
"NO_SUCH_TASK""INVALID_REQUEST"list?array<>可下载的模型文件列表。
Example Request
curl -X POST 'https://api.hyper3d.com/api/v2/download' \ -H 'Content-Type: application/json' \ -d '{ "task_uuid": "123e4567-e89b-12d3-a456-426614174000"}'Example Response
{ "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"}'
响应
{
"list": [
{
"name": "model.glb",
"url": "https://example.invalid/download/model.glb"
}
]
}
可用性与错误
仅在所有 job 都为 Done 后调用此接口；该 endpoint 不承诺拒绝尚未完成的任务。HTTP 201 返回当前可用文件，400 表示请求无效，401 表示鉴权无效，429 表示触发限流。下载链接可能过期，应及时下载文件，不要长期保存链接。