tencent cloud

Tencent HY

Product Introduction
Product Overview
Product Strengths
Use Cases
Quick Start
Tencent HY 3D Global Quick Start
Purchase Guide
Tencent HY Text Generation Global Billing Overview
Tencent HY 3D Global Billing Overview
Purchase Method
Payment Overdue
Refund
Operation Guide
Tencent HY 3D Global Prompt Guide
API Documentation
History
Introduction
API Category
Making API Requests
Hunyuan Text APIs
Hunyuan 3D APIs
Data Types
Error Codes
Related Agreement
Tencent HY 3D Glodal & Text Generation
FAQs
Tencent Hunyuan 3D Common Issues
Contact Us
DocumentationTencent HY API DocumentationData Types

Data Types

PDF
Focus Mode
Font Size
Last updated: 2026-03-25 22:20:44

ErrorMsg

Runtime exception message.

Used by actions: ChatTranslations.

Name Type Description
Msg String Error message.
Code Integer Error code.
4000 internal service error.
4001 request model timeout.

File3D

3D model related files, files or textures.

Used by actions: Describe3DSmartTopologyJob, DescribeHunyuanTo3DUVJob, QueryHunyuan3DPartJob, QueryHunyuanTo3DProJob, QueryHunyuanTo3DRapidJob, QueryHunyuanTo3DTextureEditJob.

Name Type Required Description
Type String No 3D model or texture. valid values: GIF or OBJ or Image.
Url String No Specifies the file Url (valid for 24 hours).
PreviewImageUrl String No Preview image Url.

ImageInfo

Image information.

Used by actions: SubmitHunyuanTo3DTextureEditJob.

Name Type Required Description
Url String No Image Url.
Base64 String No Image Base64.

InputFile3D

3D file.

Used by actions: Submit3DSmartTopologyJob, SubmitHunyuan3DPartJob, SubmitHunyuanTo3DTextureEditJob, SubmitHunyuanTo3DUVJob.

Name Type Required Description
Url String Yes Specifies the file Url with a valid period of 24 hours.
Type String Yes Specifies the file format.

PromptTokensDetails

Specifies the detailed information of the input token.

Used by actions: ChatTranslations.

Name Type Description
CachedTokens String The number of cache tokens.

Reference

Translate dialogue reference example.

Used by actions: ChatTranslations.

Name Type Required Description
Type String No Translate text type, enumerate "sentence" means sentence, "term" means terminology.
Text String No Original.
Translation String No Translation.

TranslationChoice

Translate the reply returned by the translation api, support multiple.

Used by actions: ChatTranslations.

Name Type Description
FinishReason String End flag, can be stop or sensitive.
stop means output ends normally.
sensitive only appears when streaming output review is enabled, indicating security review not passed.
Index Integer Index value, used when streaming.
Delta TranslationDelta Incremental return value used when streaming this field.
Message TranslationMessage Return value, used when non-streaming.

TranslationDelta

Translate the API response content (streaming return).

Used by actions: ChatTranslations.

Name Type Description
Role String Role name.
Content String Content details.

TranslationMessage

Translate the session content via translation api.

Used by actions: ChatTranslations.

Name Type Description
Role String Role. valid values: system, user, assistant, tool.
Content String Text content.

Usage

Token quantity.

Used by actions: ChatTranslations.

Name Type Description
PromptTokens Integer Input Token quantity.
CompletionTokens Integer Output Token quantity.
TotalTokens Integer Total Token quantity.
PromptTokensDetails PromptTokensDetails Details of the input token.

ViewImage

Multi-Perspective images.

Used by actions: SubmitHunyuanTo3DProJob.

Name Type Required Description
ViewType String No Specifies the viewing angle type.
Valid values: back, left, right.
ViewImageUrl String No Image Url.
ViewImageBase64 String No base64 address of the image.
Previous Topic: Convert3DFormatNext Topic: Error Codes

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback