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.

Эндпоинты

POST /v1/queue/tencent_hunyuan_3d # Создать задачу

GET /v1/queue/tencent_hunyuan_3d/requests/{request_id}/status # Проверить статус

GET /v1/queue/tencent_hunyuan_3d/requests/{request_id}/response # Получить результат

PUT /v1/queue/tencent_hunyuan_3d/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

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 обязательно

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.

Параметры ответа

{
  "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
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции