Free Quota
Upon first-time activation of the Tencent Hunyuan Large Model 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 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 becomes 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 the Console > Settings > Postpaid Settings to enable post-payment. Product Series | API name | Free Tier |
Tencent Hunyuan 3D Global | Tencent Hunyuan 3D Global (Professional Edition) | 200 credits/user |
Billing Mode
Tencent Hunyuan 3D Global common credits resource package, applicable to Tencent Hunyuan 3D Global (Professional Edition) API capability.
Product Series | API name | Basic Billing (Required) |
Tencent Hunyuan 3D Global | Tencent Hunyuan 3D Global (Professional Edition) | Resource package/Postpaid |
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 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 Hunyuan 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 Hunyuan 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 Hunyuan 3D Global | Tencent Hunyuan 3D Global (Professional Edition) | 0.02 | Daily settlement |
Concurrency Additional Package (Prepaid)
If no concurrency additional package is purchased, the Tencent Hunyuan 3D Global (Professional Edition) API provides 3 concurrency by default. This limit is shared by your root account and sub-accounts. You can go to the Purchase Page to buy concurrency additional packages to increase the number of concurrent tasks based on the API default concurrency. API Name | Monthly purchase |
Tencent Hunyuan 3D Global (Professional Edition) | 5,000 USD/concurrency/month |
Note:
Concurrency: the number of concurrenct 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 Hunyuan 3D Global (Professional Edition)
When using the Tencent Hunyuan 3D Global(Professional Edition) API, calling different parameters will deduct different credits. By default, it is text/image-to-3D in ordinary texture mode, consuming 20 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 20 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 untextured geometry models (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 Material, including metallic, roughness, and normal texture | 10.00 |
FaceCount | Generate 3D models with custom face count | 10.00 |
Billing and Settlement Method
The settlement order for Tencent Hunyuan 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, after the prepaid resource package is used up or expires, it will not automatically switch to postpaid. To use the postpaid mode for settlement, go to the Tencent Hunyuan 3D Global Console > Settings > Postpaid Settings to enable post-payment. Fees Calculation Example
Prepaid Resource Package
Example one:
The user used the "LowPoly" generation mode in the [GenerateType] parameter and enabled the [PBR] parameter, consuming 25 + 10 = 35 (credits) per API call.
Example two:
Users are expected to make 30,000 cumulative calls to Tencent Hunyuan 3D Global (Professional Edition) API within one year. They can purchase three 10,000-credits Tencent Hunyuan 3D Global credits packages, and the fee required is calculated as follows:
145 × 3 = 435 (USD)
Postpaid
The user's cumulative calls to Tencent Hunyuan 3D Global (Professional Edition) API on the current day amount to 1,000 credits.Have 100 free points remaining in Tencent Hunyuan 3D Global. The fee required is calculated as follows:
(1000 - 100) × 0.02 = 18 (USD)