HY-3D-UV 调用指南
下载
聚焦模式
字号
简介
UV 展开接口，输入3D 模型后，可自动化生成高质量 UV 切线模型。
对接说明
1. 获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
说明：
每个账户的密钥都只能当前账户查询，主账户的密钥信息子账户是看不到，子账户如果需要调用接口，需要使用账户自行创建密钥信息。
如果子账户没有办法创建，可能是没有权限创建密钥，需要主账户授权，主账户登录之后点击用户列表，在对应的子账户后面选择授权，会弹出关联策略的弹窗，输入授权策略名称之后搜索，选择对应的策略点击确认。
授权策略：QcloudTokenhubFullAccess
2. 并发额度
默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
并发任务数：表示在调用对应服务的时段内最大可运行的任务数，该任务未完成时，无法提交下一个任务，该任务完成后，可提交下一个任务。
接口文档
提交 UV 展开任务
输入参数
参数名称 | 必选 | 类型 | 描述 |
model | 是 | string | UV 展开模型名称，默认为 hy-3d-uv。 示例值：hy-3d-uv |
file | 是 | object | 需进行 UV 展开的3D 文件 url。 大小：60M 格式：fbx,obj,glb 格式 其他要求：输入文件面数3W，组件或者连通域数量不超过100个 |
输出参数
参数名称 | 类型 | 描述 |
id | string | 任务 id（有效期24小时）。 示例值：1315932989749215232 |
request_id | string | 唯一请求 id，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 request_id）。定位问题时需要提供该次请求的 request_id。 |
object | string | 返回对象类型。3d 任务固定返回 3d_job。 |
created_at | integer | 任务创建时间。 |
status | string | completed：任务成功，failed：任务失败，in_progress：执行中，queued：等待中。 示例值：completed |
查询 UV 展开任务
输入参数
参数名称 | 必选 | 类型 | 描述 |
model | 是 | string | UV 展开模型名称，默认为 hy-3d-uv。 示例值：hy-3d-uv |
id | 是 | string | 任务 id。 示例值：1357237233311637504 |
输出参数
参数名称 | 类型 | 描述 |
status | string | completed：任务成功，failed：任务失败，in_progress：执行中，queued：等待中。 示例值：completed |
request_id | string | 唯一请求 id，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 request_id）。定位问题时需要提供该次请求的 request_id。 |
object | string | 返回对象类型。3d 任务固定返回 3d_job。 |
created_at | integer | 任务创建时间。 |
completed_at | integer | 任务完成时间。 |
data | array of object |
示例
提交 UV 展开任务
输入示例
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/api/3d/submit' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-d '{"model": "hy-3d-uv","file": {"url": "https://example.com/test.fbx"}}'
输出示例
{"id": "14721*****320","request_id": "11f64379-bb0b-46b2-b89f-17d75fc12365","object": "3d_job","created_at": 1784885898,"status": "queued"}
查询 UV 展开任务
输入示例
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/api/3d/query' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-d '{"model": "hy-3d-uv","id": "14721*****320"}'
输出示例
{"request_id": "74a967e4-0e81-48c1-afde-555b79a1cdf3","object": "3d_job","created_at": 1786947866,"completed_at": 1786947866,"status": "completed","data": [{"type": "obj","url": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/texture_to_3d/output/1254418******-4b66-bc94-8ad7285e659f.obj"},{"type": "fbx","url": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/texture_to_3d/output/125441*****3-4b66-bc94-8ad7285e659f.fbx"},{"type": "image","url": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/texture_to_3d/output/125441*****d3-4b66-bc94-8ad7285e659f_latent.png"}]}
数据结构
file
输入3D 模型文件对象。
参数名称 | 必选 | 类型 | 描述 |
type | 否 | string | 3D 模型文件类型。 示例值：fbx |
url | 是 | string | 3D 模型文件地址。 |
data
生成结果对象。
参数名称 | 类型 | 描述 |
type | string | 生成结果文件类型。 示例值：obj |
url | string | 生成结果文件下载地址。 |
文档反馈