Введение
Tripo H3.1 — модель для превращения изображения в 3D, которую Tripo AI представила в марте 2026 года для ассетов производственного уровня: геометрия чётче, верность исходной картинке выше, текстуры качественнее, чем у прежних моделей серии H. Вы отправляете одно изображение (image_url) и получаете один бинарный файл glTF (.glb). В отличие от конвертеров с единственным переключателем, здесь открыт каждый этап конвейера: текстурировать ли сетку, PBR-карты, HD-текстуры, детальная геометрия, квад-топология, целевое число граней, реальный масштаб, итоговая ориентация и два отдельных сида. Промпта нет.
Ключевые возможности и особенности
Форма по изображению
В тесте с ботинком модель сохранила пропорции снимка и поставила петлю на пятке, крючки для шнурков и протектор на правильные стороны, хотя на фото был только перед. Текстурированный результат перенёс на сетку потёртую кожу, красные шнурки и строчку.
Текстуры, которые можно включать и улучшать
Текстуры включены по умолчанию и приходят полным PBR-набором. В нашем файле с настройками по умолчанию в одном материале были карта базового цвета, metal-roughness и нормалей по 2048 пикселей. texture_quality: detailed запрашивает текстуры более высокого разрешения, extreme даёт 8K, а fast сохраняет стандартный размер и завершается быстрее; если выключить и generate_texture, и generate_pbr, вернётся простая сетка по самой низкой цене.
Топология и размер под вашим контролем
face_limit ограничивает число граней в диапазоне от 1 000 до 2 000 000, quad_mesh переключает на четырёхугольники для правки в программе моделирования, а geometry_quality: detailed тратит больше на мелкий рельеф. auto_size масштабирует сетку до реальных размеров, а model_orientation: align_image поворачивает её как на снимке.
Лоу-поли сетки и отдельные части
low_poly заменяет плотную, похожую на скан поверхность чистой лоу-поли топологией для простых предметов: наш ботинок с face_limit: 5000 вернулся примерно за три минуты как GLB на 0,38 МБ с 7 675 треугольниками. generate_parts вместо этого делит объект на именованные части внутри одного GLB; наш игрушечный космонавт вернулся за 78 секунд как 18 частей без текстур, всего 47 304 треугольника.
Что мы измерили
С настройками по умолчанию фронтальный кадр кожаного ботинка 1024×1024 за 167 секунд превратился в GLB на 45,8 МБ с 1 471 382 треугольниками и тремя текстурами. Именно из-за такой плотности для всего, что показывается в браузере, стоит задавать face_limit.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Изображение для модели: JPEG, PNG или WebP до 10 МБ. Один объект целиком в кадре на однотонном фоне; ракурс в три четверти даёт модели больше всего информации о глубине. Не менее 1 символов |
generate_texture | Нет | Включено по умолчанию. Наносит текстуру на сетку. По умолчанию: |
generate_pbr | Нет | Включено по умолчанию. Добавляет к базовому цвету PBR-карты материала (metal-roughness и нормали) и включает текстурирование даже при выключенном |
texture_quality | Нет | standard (по умолчанию), detailed, extreme или fast. |
texture_version | Нет | v3.0-20250812 (по умолчанию) или новая версия v3.5-20260815. |
remove_lighting | Нет | Включено по умолчанию. Убирает блики и тени, запечённые в изображении, до наложения текстур, чтобы модель реагировала на освещение вашей сцены. По умолчанию: |
geometry_quality | Нет | standard (по умолчанию) или detailed. detailed строит более тонкий рельеф поверхности и является самой дорогой надбавкой. |
quad_mesh | Нет | Выключено по умолчанию. По умолчанию: |
low_poly | Нет | Выключено по умолчанию. Включение строит лёгкую сетку с чистой топологией в стиле ручного моделирования, лучше всего для простых предметов; держите |
generate_parts | Нет | Выключено по умолчанию. Включение возвращает модель отдельными именованными частями в одном GLB (18 частей у нашего игрушечного космонавта). По умолчанию: |
face_limit | Нет | Необязательное целевое число граней, от 1 000 до 2 000 000. |
image_autofix | Нет | Выключено по умолчанию. Включение исправляет размытое, зашумлённое или низкого разрешения изображение перед моделированием; это занимает больше времени. По умолчанию: |
model_orientation | Нет | default сохраняет стандартную ориентацию модели; |
texture_alignment | Нет |
|
auto_size | Нет | Выключено по умолчанию. При включении масштабирует сетку до оценочных реальных размеров — удобно для AR и печати. По умолчанию: |
uv_unwrap | Нет | Включено по умолчанию. Выключение пропускает UV-развёртку, что ускоряет работу и уменьшает файл, но у сетки тогда не будет текстурных координат для последующего наложения текстур. По умолчанию: |
seed | Нет | Необязательный сид этапа геометрии. Зафиксируйте его, чтобы повторить ту же форму. |
texture_seed | Нет | Необязательный сид этапа текстуры. Зафиксируйте seed и меняйте этот, чтобы пробовать новые текстуры на той же форме. |
Стоимость
$0.432 / модель
Каждый запрос оплачивается один раз при выдаче модели: базовая цена за сетку плюс фиксированные надбавки за текстуры (generate_texture или generate_pbr), детальные или 8K-текстуры, детальную геометрию, квад-топологию, лоу-поли топологию и отдельные части. С включённым generate_parts надбавки за текстуры и квад-топологию не начисляются, так как части — это треугольные сетки без текстур. Число граней, масштаб, ориентация, выравнивание, версия текстур, удаление освещения, UV-развёртка, исправление изображения и сиды на цену не влияют, а неудачный запрос не оплачивается.
Сценарии использования
Ассеты для игр, AR и сцен реального времени
Подгоните face_limit под бюджет сцены, включите quad_mesh, если ассет будут дорабатывать, и оставьте PBR, чтобы модель реагировала на освещение. Один запрос на объект сохраняет набор ассетов единообразным и дешёвым для перегенерации.
Визуализация товаров и печать
Для просмотрщика товаров оставьте текстуры включёнными и используйте texture_quality: detailed, если надписи или строчки должны читаться. Для 3D-печати и скульптинга выключите оба переключателя текстур и включите auto_size, чтобы сетка пришла в реалистичном масштабе.
Руководство по промптам и практические советы
Начните с чистого изображения
Один объект целиком в кадре на однотонном фоне. Ракурс в три четверти сообщает модели о глубине больше, чем фронтальный. JPEG, PNG или WebP до 10 МБ.
Включайте только нужное
Каждая платная опция увеличивает цену: текстуры, HD- или 8K-текстуры, детальная геометрия, квад-топология, лоу-поли топология и отдельные части. Сделайте первый прогон с настройками по умолчанию и face_limit, а затем улучшайте только тот этап, которого не хватает.
Используйте два сида для итераций
seed фиксирует геометрию, а texture_seed — текстуру. Держите seed неизменным и меняйте texture_seed, чтобы пробовать новые поверхности на той же форме, или держите texture_seed, пока ищете форму.
Проверьте скрытую сторону
Перед использованием откройте GLB в просмотрщике и поверните его на полный оборот. Если невидимая сторона получилась неверной, другой ракурс камеры на исходном снимке поможет больше любой настройки.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/h3.1/image-to-3d",
"input": {
"generate_parts": false,
"generate_pbr": true,
"generate_texture": true,
"geometry_quality": "standard",
"image_url": "https://example.com/reference.png",
"low_poly": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.










