Hunyuan 3D Rapid

tencent-hunyuan-3d-rapid Hunyuan 3D Rapid — быстрая 3D-модель для превращения текста или изображений в 3D-ассеты, готовые к черновому использованию. Она полезна для быстрых превью, исследования ассетов и быстрой креативной итерации.

Эндпоинты

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

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

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

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

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

curl --location "https://api.odirouter.ai/model/v1/queue/tencent-hunyuan-3d-rapid" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "image_base64": "data:image/png;base64,BASE64_IMAGE_DATA",
    "result_format": "GLB",
    "enable_pbr": false
  }'

prompt string

Промпт Text-to-3D. Можно передать ровно один из параметров: prompt, image_url или image_base64.

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

image_base64 string

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

Принимается как data URI, например data:image/png;base64,..., так и необработанные данные изображения Base64.

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

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

image_url string

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

По возможности используйте image_base64. Если URL недоступен для сервиса, задача может завершиться ошибкой.

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

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

result_format string

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

Варианты: GLB, OBJ

enable_pbr bool

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

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

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

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

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