Tencent Hunyuan 3D Global Billing Overview
Last updated: 2026-01-06 18:18:14
Free Quota
Upon first-time activation of the Tencent HY service, the following APIs will grant a free call tier for your testing experience. The free quota will be provided using a one-time free resource package and will be deducted first during billing and settlement. The free resource package is valid for 1 year. If the count of API calls in the free resource package is not used up within 1 year after service activation, it will become invalid.
By default, after the free resource package is used up or expires, it will not automatically switch to postpaid. If you have not purchased a prepaid resource package or have not actively activated the postpaid service, a billing exception error will occur. To use the postpaid mode for settlement, please go to Console > Settings > Postpaid to enable post-payment.
Product Series | API name | Free Tier |
Tencent HY 3D Global | Tencent HY 3D Global (Professional) | 200 credits/user |
| Tencent HY 3D Global (Express) | |
| 3D Part Generation | |
Billing Mode
Tencent HY 3D Global common credits resource package is applicable to Tencent HY 3D Global (Professional) API capability.
Product Series | API name | Basic Billing (Required) |
Tencent HY 3D Global | Tencent HY 3D Global (Professional) | Resource Package/Postpaid |
| Tencent HY 3D Global (Express) | |
| 3D Part Generation | |
Credits Resource Package (Prepaid)
A resource package is valid for 1 year. If the credits in the resource package are not used up within 1 year from the date of purchase, they will become invalid. After the resource package is used, the remaining credits cannot be put on hold or suspended. If a purchased resource package is not used, you can refund it within 7 days unconditionally. The resource package can only deduct the number of API calls generated after purchase.
Service Name | Prepaid Package Validity Period | Credits Quantity | Resource Package Price (USD) | Unit Price (USD/Credits) |
Tencent HY 3D Global | 1 year | 1,000 | 15 | 0.015 |
| | 10,000 | 145 | 0.0145 |
| | 50,000 | 700 | 0.014 |
| | 100,000 | 1,350 | 0.0135 |
Postpaid (By Credits)
Postpaid adopts daily settlement. The bill for the previous day's usage is generated and charged daily.
Tencent HY 3D Global related postpaid billing is based on credits, with the billing standard as follows:
Service Name | API name | Unit Price (USD/Credits) | Billing Cycle |
Tencent HY 3D Global | Tencent Hunyuan 3D Global (Professional Edition) | 0.02 | Daily settlement |
| Tencent Hunyuan 3D Global (Ultra-Fast Version) | | |
| Component generation | | |
Concurrency Additional Package (Prepaid)
If no concurrency add-on package is purchased, the Tencent HY 3D Global (Professional) API has a default limit of 3 concurrency, while the Tencent HY 3D Global (Express) component generation API has a default limit of 1 concurrency. This limit is shared between main and sub-accounts. You can go to the Purchase Page to buy add-on packages to enhance the API concurrency limit.
API Name | Monthly purchase |
Tencent Hunyuan 3D Global (Professional Edition) | 5,000 USD/concurrency/month |
Tencent Hunyuan 3D Global (Ultra-Fast Version) | 5,000 USD/concurrency/month |
Component generation | 5,000 USD/concurrency/month |
Note:
Concurrency: the number of concurrent tasks that can be processed simultaneously. If the concurrency is m, at most m submitted tasks can be processed simultaneously at a time, and the next task can only be processed after the previous task is completed..
You can purchase concurrency additional packages to increase the number of concurrent tasks based on the API default concurrency. For example, if the API provides m concurrency by default and you purchase n concurrency additional packages, your root account and sub-accounts can use m + n concurrency totally.
Credits Deduction Instructions
Tencent HY 3D Global (Professional)
When using the Tencent HY 3D Global (Professional) API, calling different parameters will deduct different credits. By default, it is text/image-to-3D in ordinary texture mode, consuming 25 credits per call.
Failed tasks do not deduct credits (no deduction for any failure, including failures caused by risk control policy).
[Generate task type]
The [GenerateType] parameter can be used to specify the task type. This is a required option, with [Normal] as the default option, which generates a 3D model with textures and consumes 25 credits.
The [GenerateType] parameter offers other task types. Select 1 of 4 available 3D file patterns, consuming credits based on the generation type.
Generate task type | Feature Description | Consume Credits |
Normal | Generate textured geometry models | 25.00 |
LowPoly | Generate textured geometry models with intelligent mesh reduction | 30.00 |
Geometry | Generate geometry models without textures (white models) | 15.00 |
Sketch | Enter sketches or line drawings to generate textured geometry models | 25.00 |
[Additional Parameter]
Can be used after selecting the task generation type. The following parameters allow multiple options and will accumulate credits consumption based on additional usage.
Generate task type | Feature Description | Additional Credits consumption |
MultiViewImages | Generate 3D models with multi-view | 10.00 |
EnablePBR | Generate 3D models with PBR materials, including metallic, roughness, and normal maps | 10.00 |
FaceCount | Generate 3D models with custom face count | 10.00 |
Tencent HY 3D Global (Express)
When using the Tencent HY 3D Global (Express) API, calling different parameters will deduct different credits. By default, it is text/image-to-3D in ordinary texture mode, consuming 15 credits per call.
Generate task type | Feature Description | Additional Credits consumption |
Prompt | Generate 3D models from text | 15.00 USD/call |
ImageUrl/ImageBase64 | Generate 3D models from images | 15.00 USD/call |
[Additional Parameter]
Selectable extra parameters can be used, and credits consumption will accumulate based on additional usage.
Generate task type | Feature Description | Additional Credits consumption |
EnablePBR | Generate 3D models with PBR materials, including metallic, roughness, and normal maps | 10.00 USD/call |
Value Added Feature (Post-Processing)
During actual generation, calling different APIs will deduct different points.
Failed tasks do not deduct credits (no deduction for any failure, including failures caused by risk control policy).
Generate task type | Feature Description | Additional Credits consumption |
3D Part Generation | After inputting a 3D model, the system can automatically identify the model structure and generate corresponding 3D components. | 30 credits/call |
Billing and Settlement Method
The settlement order for Tencent HY 3D Global is: purchased prepaid resource package > postpaid.
In pay-as-you-go mode, billing is based on API calls (credits). Failed API calls are not charged.
By default, prepaid resource packages will not automatically switch to post-payment upon expiry or when the quota is used up. To use postpaid mode for settlement, please visit the Tencent HY Console > Settings > Postpaid Settings to enable post-payment.
Fees Calculation Examples
Prepaid Resource Package
Example one:
The user used the "LowPoly" generation mode in the [GenerateType] parameter and enabled the [PBR] parameter, consuming 30 + 10 = 40 (credits) per API call.
Example two:
Users are expected to make 30,000 cumulative calls toTencent HY 3D Global (Professional) API within one year. They can purchase three 10,000-credits Tencent HY 3D Global credits packages, and the fee required is calculated as follows:
145 × 3 = 435 (USD)
Postpaid
The user's cumulative calls to Tencent HY 3D Global (Professional) API on the current day amount to 1,000 credits. The user has 100 free points remaining in Tencent HY 3D Global. The fee required is calculated as follows:
(1000 - 100) × 0.02 = 18 (USD)
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback