HY-3D-UV API Guide
ダウンロード
フォーカスモード
フォントサイズ
Introduction
The UV unwrapping interface can automatically generate a high-quality UV seam model after a 3D model is input.
Integration Guide
1. Obtaining an API Key
1. Go to the API Key Management page and click Create API Key. For detailed operations, see Create API Key.
2. After creation, be sure to copy and securely store the API Key. This information will be used in the subsequent process of configuring the tool.
Note:
The key of each account can only be queried by that account. Sub-accounts cannot view the key information of the main account. If a sub-account needs to call APIs, it must create its own key information.
If a sub-account cannot be created, the user may not have permission to create keys and needs authorization from the main account. After the main account logs in, click User List, and select Authorize next to the corresponding sub-account. A dialog box for associating policies will appear. Enter the authorization policy name and search, then select the corresponding policy and click Confirm.
Authorization policy: QcloudTokenhubFullAccess
2. Concurrency Quota
One concurrent task is provided by default, meaning that at most one submitted task can be processed at a time. The next task can start only after the previous task is completed.
Concurrent tasks: the maximum number of tasks that can run during the period when the corresponding service is being called. While a task is not completed, the next task cannot be submitted. After the task is completed, the next task can be submitted.
API Documentation
Submitting a UV Unwrapping Task
Input parameters
Parameter Name | Required | Type | Description |
model | Yes | string | Name of the UV unwrapping model. Default value: hy-3d-uv. Example value: hy-3d-uv |
file | Yes | object | url of the 3D file that requires UV unwrapping. Size: 60M Format: fbx, obj, glb Other requirements: The input file has 30,000 faces, and the number of components or connected domains does not exceed 100. |
Output parameters
Parameter Name | Type | Description |
id | string | Task id (valid for 24 hours). Example value: 1315932989749215232. |
request_id | string | Unique request id, generated by the server and returned for each request (if a request fails to reach the server for other reasons, no request_id is returned for that request). Provide the request_id of the request when locating issues. |
object | string | Type of the returned object. For 3d jobs, the value is fixed as 3d_job. |
created_at | integer | Task creation time. |
status | string | completed: task succeeded, failed: task failed, in_progress: in progress, queued: queued. Example value: completed. |
Querying a UV Unwrapping Task
Input parameters
Parameter Name | Required | Type | Description |
model | Yes | string | Name of the UV unwrapping model. Default value: hy-3d-uv. Example value: hy-3d-uv |
id | Yes | string | Task id. Example value: 1357237233311637504 |
Output parameters
Parameter Name | Type | Description |
status | string | completed: task succeeded, failed: task failed, in_progress: in progress, queued: queued. Example value: completed. |
request_id | string | Unique request id, generated by the server and returned for each request (if a request fails to reach the server for other reasons, no request_id is returned for that request). Provide the request_id of the request when locating issues. |
object | string | Type of the returned object. For 3d jobs, the value is fixed as 3d_job. |
created_at | integer | Task creation time. |
completed_at | integer | Task completion time. |
data | array of object | List of generated results, including generated 3d model files and related resource information. For details, see the data data structure. |
Examples
Submitting a UV Unwrapping Task
Input example
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"}}'
Output example
{"id": "14721*****320","request_id": "11f64379-bb0b-46b2-b89f-17d75fc12365","object": "3d_job","created_at": 1784885898,"status": "queued"}
Querying a UV Unwrapping Task
Input example
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"}'
Output example
{"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"}]}
Data Structure
file
Input a 3D model file object.
Parameter Name | Required | Type | Description |
type | No | string | 3D model file type. Example value: fbx |
url | Yes | string | 3D model file URL. |
data
Generate a result object.
Parameter Name | Type | Description |
type | string | Type of the generated result file. Example value: obj. |
url | string | Download URL of the generated result file. |
フィードバック