Hunyuan 3D Standard

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

Эндпоинты

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://api.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, image_url или image_base64.

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

image_base64 string

Входное изображение в кодировке Base64. Можно передать ровно один из параметров: prompt, image_url или image_base64.

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

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

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

image_url string

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

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

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

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

result_format string

Целевой формат экспорта для сгенерированного 3D-ассета или preview-вывода.

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

enable_pbr bool

Генерировать ли PBR-материалы для выходного ассета.

multi_view_images array

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

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

Для каждого вида допускается только одно изображение.

Ограничение размера изображений: общий закодированный размер всех изображений не должен превышать 8MB. Для входа Base64 общий исходный размер изображений не должен превышать 6MB, потому что кодирование Base64 увеличивает размер изображения примерно на 30%.

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

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

ViewType string required

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

Варианты: left, right, back

ViewImageUrl string

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

ViewImageBase64 string

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

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

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

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