tencent cloud

LLM Service TokenHub

ドキュメントLLM Service TokenHubAPI Integration Guide3D Generation ModelsHY API GuideHY-3D-Format API Guide

HY-3D-Format API Guide

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-11-09 11:37:03
AI翻訳

Introduction

The component generation interface can automatically identify the model structure after a 3D model is input, and generate the corresponding 3D components for the model.

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 Component Generation Task

Input parameters
Parameter Name
Required
Type
Description
model
Yes
string
Name of the component generation model. Default value: hy-3d-component.
Example value: hy-3d-component
file
Yes
input_file_3d
3d model file for component generation. Only fbx format is supported.
part_segmentation_info
No
string
Whether to generate components in stages.
After this feature is enabled, you can input the original model to generate a model with segmentation information and segmentation data. You can edit this information and then pass in the edited model with segmentation information and segmentation data for component generation.
This parameter is disabled by default.
Example value: {"part_0": {"face_ids": [ xxx ]}
enable_staged_generation
No
boolean
Whether to generate components in stages.
After this feature is enabled, you can input the original model to generate a model with segmentation information and segmentation data. You can edit this information and then pass in the edited model with segmentation information and segmentation data for component generation.
This parameter is disabled by default.
Example value: true.
enable_post_process
No
boolean
Whether to enable post-processing. After it is enabled, only one model link is output. It is disabled by default. (After this API is enabled, an additional 20 points are required.)
Example value: true.
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 Component Generation Tasks

Input parameters
Parameter Name
Required
Type
Description
model
Yes
string
Component generation model version. Default value: hy-3d-component.
Example value: hy-3d-component
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.
data
array of object
List of generated results, including generated 3d model files and related resource information. For details, see the data data structure.
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.

Examples

Submitting a Component Generation 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-component",
    "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 Component Generation Tasks

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-component",
    "id": "14721*****320"
  }'
Output example
{
  "request_id": "6df5ce8a-1290-4c2e-aff1-0740fd6e30eb",
  "object": "3d_job",
  "created_at": 1787043728,
  "completed_at": 1787043728,
  "status": "completed",
  "data": [
    {
      "type": "glb",
      "url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3dpart/output/12544******5-afddb37d7c21_1787043584_part_0.glb"
    },
    {
      "type": "glb",
      "url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3dpart/output/12544******5-afddb37d7c21_1787043584_part_0.glb"
    },
    {
      "type": "glb",
      "url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3dpart/output/12544******5-afddb37d7c21_1787043584_part_0.glb"
    },
    {
      "type": "glb",
      "url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3dpart/output/12544******5-afddb37d7c21_1787043584_part_0.glb"
    }
  ]
}

Data Structure

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.



前の記事へ: HY-3D-Component API Guide次の記事へ: HY-3D-Texture API Guide

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation