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 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 > Settings > Postpaid Settings to enable post-payment.
|
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.
|
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 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.
|
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:
|
Tencent HY 3D Global | Tencent HY 3D Global (Professional) | 0.02 | Daily settlement |
| Tencent HY 3D Global (Express) |
|
|
| 3D Part 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. |
Tencent HY 3D Global (Professional) | 5,000 USD/concurrency/month |
Tencent HY 3D Global (Express) | 5,000 USD/concurrency/month |
3D Part 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 in total.
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.
|
Normal | Generate a textured geometry model | 25.00 |
LowPoly | Generate a textured geometry model with intelligent mesh reduction | 30.00 |
Geometry | Generate a geometry model without textures (white model) | 15.00 |
Sketch | Enter a sketch or line drawing to generate a textured geometry model | 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.
|
MultiViewImages | Generate 3D models from multi-view | 10.00 |
EnablePBR | Generate 3D models with PBR materials, including metallic, roughness, and normal textures | 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 amounts of points. The default is generating 3D models from text or images, normal texture mode, which consumes 15 credits per use.
|
Prompt | Generate 3D models from text | 15.00 USD/time |
ImageUrl/ImageBase64 | Generate 3D models from images | 15.00 USD/time |
[Additional Parameter]
Additional parameters are available. Credits consumption will accumulate based on extra usage.
|
EnablePBR | Generate 3D models with PBR materials, including metallic, roughness, and normal textures | 10.00 USD/time |
Value Added Feature (Post-Processing)
During actual generation, calling different APIs will deduct different credits.
Failed tasks do not deduct credits (no deduction for any failure, including failures caused by risk control policy).
|
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, 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 HY 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 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)