Hunyuan 3D v3.1
model-hunyuan-3d-v3-1POST/v1/generationsОриентирот 66,94 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#promptstringобязательныйЧто нужно создать? — Опишите сюжет, композицию, стиль и важные детали.
- По умолчанию
- нет
- Ограничения
- до 600 символов · сценарии: scenario-1
input_image_urlfile · inputAssetsобязательныйИзображение объекта — Вместо текста можно загрузить изображение объекта.
- По умолчанию
- нет
- Ограничения
- форматы: image/* · сценарии: scenario-0
enable_pbrbooleanнеобязательныйPBR-материалы
- По умолчанию
true
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0передан файл input_image_url
Активные поля: input_image_url, enable_pbr
{
"model": "model-hunyuan-3d-v3-1",
"values": {
"enable_pbr": true
},
"inputAssets": [
{
"fieldName": "input_image_url",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-1по умолчанию
Активные поля: prompt, enable_pbr
{
"model": "model-hunyuan-3d-v3-1",
"values": {
"prompt": "Describe the desired result",
"enable_pbr": true
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 66,94 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.
Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.
Машиночитаемая схема: GET /v1/generation-models/model-hunyuan-3d-v3-1. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.