Hunyuan 3D Pro

tencent-hunyuan-3d-pro Hunyuan 3D Pro генерирует 3D-ассеты из текста, изображений, скетчей и многопроекционных референсов. Она подходит для более контролируемого создания ассетов, стилизованного моделирования и ориентированных на продакшен 3D‑процессов.

Эндпоинты

POST /v1/queue/tencent-hunyuan-3d-pro # Создать задачу

GET /v1/queue/tencent-hunyuan-3d-pro/requests/{request_id}/status # Проверить статус

GET /v1/queue/tencent-hunyuan-3d-pro/requests/{request_id}/response # Получить результат

PUT /v1/queue/tencent-hunyuan-3d-pro/requests/{request_id}/cancel # Отменить задачу

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

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

prompt string

Промпт Text-to-3D. В текущих доступных режимах Normal и Geometry можно передать ровно один из параметров: prompt, image_url или image_base64.

Максимальная длина: 1024 символа UTF-8

image_base64 string

Входное изображение в кодировке Base64. В текущих доступных режимах Normal и Geometry можно передать ровно один из параметров: prompt, image_url или image_base64.

Поддерживаемые форматы: jpg, png, jpeg, webp

Размер изображения: wrapper-слой рекомендует до 8MB

Разрешение: каждая сторона должна быть от 128 до 5000 пикселей

image_url string

Публично доступный URL входного изображения. В текущих доступных режимах Normal и Geometry можно передать ровно один из параметров: prompt, image_url или image_base64.

Поддерживаемые форматы: jpg, png, jpeg, webp

Размер изображения: до 8MB

Разрешение: каждая сторона должна быть от 128 до 5000 пикселей

face_count int

Целевое количество граней для сгенерированной 3D-модели.

Диапазон: 3000 - 1500000

По умолчанию: 500000

generate_type string

Тип задачи генерации, который управляет стилем модели и поведением вывода. Normal генерирует текстурированную геометрию; Geometry генерирует белую модель без текстур и игнорирует enable_pbr.

Варианты: Normal, Geometry

По умолчанию: Normal

enable_pbr bool

Включать ли генерацию PBR-материалов. Этот параметр игнорируется, когда generate_type равен Geometry.

По умолчанию: false

result_format string

Необязательный формат экспорта, ограничивающий сгенерированную модель одним форматом. Если параметр не указан, ответы Pro могут возвращать модели OBJ и GLB вместе с preview.

Варианты: STL, USDZ, FBX

multi_view_images array

Многовидовые референсные изображения для повышения геометрической согласованности. Каждый элемент должен содержать ViewType и один из параметров: ViewImageUrl или ViewImageBase64. Для каждого вида допускается только одно изображение.

Поддерживаемые виды: back, left, right, top, bottom, left_front, right_front

Для входа URL удерживайте общий размер изображений в пределах 8MB. Для входа Base64 удерживайте общий исходный размер изображений около 6MB.

Разрешение одного изображения: каждая сторона должна быть от 128 до 5000 пикселей

Поддерживаемые форматы: jpg, png

ViewType string required

Идентификатор вида для референсного изображения.

Варианты: back, left, right, top, bottom, left_front, right_front

ViewImageUrl string

Публично доступный URL изображения для этого вида.

ViewImageBase64 string

Содержимое изображения этого вида в кодировке Base64.

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

URL итоговых 3D-ассетов могут использовать имя файла с расширением .bin. Чтобы определить фактический формат модели, используйте метаданные вывода, например metadata.format.

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/tencent-hunyuan-3d-pro/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/tencent-hunyuan-3d-pro/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/tencent-hunyuan-3d-pro/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	Текущая позиция в очереди.

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