Hunyuan 3D Standard

tencent-hunyuan-3d

Tencent Hunyuan 3D supports generating 3D assets from text or images, with PBR materials, export format selection, and multi-view reference images to improve geometry consistency.

Endpoints

POST /v1/queue/tencent-hunyuan-3d # Create task

GET /v1/queue/tencent-hunyuan-3d/requests/{request_id}/status # Check status

GET /v1/queue/tencent-hunyuan-3d/requests/{request_id}/response # Get result

PUT /v1/queue/tencent-hunyuan-3d/requests/{request_id}/cancel # Cancel task

Request parameters

curl --location "https://odirouter.ai/model/v1/queue/tencent-hunyuan-3d" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "image_url": "https://example.com/reference-image.webp",
    "result_format": "GLB",
    "enable_pbr": false
  }'

prompt string

Text-to-3D prompt. Exactly one of prompt, image_url, and image_base64 can be provided.

Maximum length: 1024 UTF-8 characters

image_base64 string

Base64 encoded input image. Exactly one of prompt, image_url, and image_base64 can be provided.

Supported formats: jpg, png, jpeg, webp

Image size: up to 8MB

Resolution: each side must be between 128 and 5000 pixels

image_url string

Publicly accessible input image URL. Exactly one of prompt, image_url, and image_base64 can be provided.

Supported formats: jpg, png, jpeg, webp

Image size: up to 8MB

Resolution: each side must be between 128 and 5000 pixels

result_format string

Target export format for the generated 3D asset or preview output.

Options: OBJ, GLB, STL, USDZ, FBX, MP4

enable_pbr bool

Whether to generate PBR materials for the output asset.

Options: true, false

multi_view_images array

Optional multi-view reference images used to improve geometry consistency. Each item must contain ViewType and one of ViewImageUrl or ViewImageBase64.

Supported views: left, right, back

Only one image is allowed for each view.

Image size limit: the total encoded size of all images must not exceed 8MB. For Base64 input, the total original image size must not exceed 6MB, because Base64 encoding increases image size by about 30%.

Image resolution limit: each side must be greater than 128 pixels and less than 5000 pixels.

Supported image formats: jpg, png

ViewType string required

View identifier for the reference image.

Options: left, right, back

ViewImageUrl string

Publicly accessible URL for the image of this view.

ViewImageBase64 string

Base64 encoded image content for this view.

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/tencent-hunyuan-3d/requests/mmsu_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/tencent-hunyuan-3d/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/tencent-hunyuan-3d/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling