Tripo 3D
model-tripo-h31POST/v1/generationsОриентирот 39 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#generation_modestring (enum)обязательныйРежим Tripo
- По умолчанию
"h31_image"
Допустимые значения
p1_imageP1 · из изображенияp1_textP1 · из текстаh31_imageH3.1 · из изображенияh31_textH3.1 · из текста
promptstringобязательныйОписание объекта — Опишите форму, материалы и важные детали будущей модели.
- По умолчанию
- нет
- Ограничения
- до 1024 символов · сценарии: scenario-0, scenario-2
image_urlfile · inputAssetsобязательныйФото объекта — Покажите объект целиком, лучше на спокойном фоне.
- По умолчанию
- нет
- Ограничения
- форматы: image/* · сценарии: scenario-1, scenario-3
negative_promptstringнеобязательный· расширенныйЧто исключить — Необязательно: перечислите нежелательные детали.
- По умолчанию
- нет
- Ограничения
- до 1024 символов · сценарии: scenario-2
pbrbooleanнеобязательныйРеалистичные материалы
- По умолчанию
true- Ограничения
- сценарии: scenario-2, scenario-3
texture_alignmentstring (enum)необязательныйНаложение текстуры — Обычно лучше оставить «По изображению».
- По умолчанию
"original_image"- Ограничения
- сценарии: scenario-3
Допустимые значения
original_imageПо изображениюgeometryПо геометрии
texturebooleanнеобязательныйДобавить текстуру
- По умолчанию
true
auto_sizebooleanнеобязательныйРазмер в метрах
- По умолчанию
false- Ограничения
- сценарии: scenario-2, scenario-3
face_limitnumberнеобязательныйКоличество полигонов
- По умолчанию
200000- Ограничения
- 48–2000000
texture_qualitystring (enum)необязательныйДетализация текстуры
- По умолчанию
"standard"- Ограничения
- сценарии: scenario-2, scenario-3
Допустимые значения
standarddetailed
quadbooleanнеобязательныйСетка из четырёхугольников
- По умолчанию
false- Ограничения
- сценарии: scenario-2, scenario-3
geometry_qualitystring (enum)обязательныйДетализация формы
- По умолчанию
"standard"- Ограничения
- сценарии: scenario-2, scenario-3
Допустимые значения
standarddetailed
orientationstring (enum)необязательныйПоворот модели
- По умолчанию
"default"- Ограничения
- сценарии: scenario-3
Допустимые значения
defaultАвтоматическиalign_imageПо изображению
image_seednumberнеобязательныйSeed изображения
- По умолчанию
- нет
- Ограничения
- сценарии: scenario-2
texture_seednumberнеобязательныйSeed текстуры
- По умолчанию
- нет
- Ограничения
- сценарии: scenario-2, scenario-3
model_seednumberнеобязательныйSeed формы
- По умолчанию
- нет
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0generation_mode = p1_text
Активные поля: generation_mode, prompt, texture, face_limit, model_seed
Ограничения сценария: {"face_limit":{"minimum":48,"maximum":20000}}
{
"model": "model-tripo-h31",
"values": {
"generation_mode": "p1_text",
"prompt": "Describe the desired result",
"texture": true,
"face_limit": 20000
},
"inputAssets": []
}scenario-1generation_mode = p1_image
Активные поля: generation_mode, image_url, texture, face_limit, model_seed
Ограничения сценария: {"face_limit":{"minimum":48,"maximum":20000}}
{
"model": "model-tripo-h31",
"values": {
"generation_mode": "p1_image",
"texture": true,
"face_limit": 20000
},
"inputAssets": [
{
"fieldName": "image_url",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-2generation_mode = h31_text
Активные поля: generation_mode, prompt, negative_prompt, pbr, texture, auto_size, face_limit, texture_quality, quad, geometry_quality, image_seed, texture_seed, model_seed
Ограничения сценария: {"face_limit":{"minimum":1000,"maximum":2000000}}
{
"model": "model-tripo-h31",
"values": {
"generation_mode": "h31_text",
"prompt": "Describe the desired result",
"pbr": true,
"texture": true,
"auto_size": false,
"face_limit": 200000,
"texture_quality": "standard",
"quad": false,
"geometry_quality": "standard"
},
"inputAssets": []
}scenario-3по умолчанию
Активные поля: generation_mode, image_url, pbr, texture_alignment, texture, auto_size, face_limit, texture_quality, quad, geometry_quality, orientation, texture_seed, model_seed
Ограничения сценария: {"face_limit":{"minimum":1000,"maximum":2000000}}
{
"model": "model-tripo-h31",
"values": {
"generation_mode": "h31_image",
"pbr": true,
"texture_alignment": "original_image",
"texture": true,
"auto_size": false,
"face_limit": 200000,
"texture_quality": "standard",
"quad": false,
"geometry_quality": "standard",
"orientation": "default"
},
"inputAssets": [
{
"fieldName": "image_url",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}Цена и результат
#Ориентир при стандартных настройках — 39 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через 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-tripo-h31. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.