Tripo H3.1 API

О модели Tripo H3.1

Точная 3D-форма и верные цвета по одному фото товара.

Вызывайте его по имени модели tripo/h3.1/image-to-3d через POST /jobs/createTask, от 0,432 $.

Введение

Tripo H3.1 — модель «изображение в 3D» от Tripo AI, представленная в марте 2026 года для производственных ассетов. По сравнению с предыдущими моделями серии H у неё более чёткая геометрия, лучшее совпадение с входным изображением и текстуры более высокого качества. Вы отправляете одно изображение (image_url) и получаете один бинарный glTF-файл (.glb). В отличие от конвертеров с одним переключателем, каждый этап конвейера открыт для настройки: текстурирование сетки, PBR-карты, HD-текстуры, детальная геометрия, топология из четырёхугольников, целевое количество граней, масштабирование до реальных размеров, итоговая ориентация и два отдельных seed. Промпта нет.

Ключевые возможности

Форма, которая следует снимку

В нашем тесте с ботинком модель сохранила пропорции фото и разместила петлю на пятке, крючки для шнурков и протектор на правильных сторонах, хотя на фото была видна только передняя часть. Текстурированный результат перенёс потёртую кожу, красные шнурки и строчки на сетку.

Текстуры можно включать и улучшать

Текстуры включены по умолчанию и поставляются полным PBR-набором. В нашем файле с настройками по умолчанию в одном материале были карта базового цвета 2048 пикселей, карта metal-roughness и карта нормалей.

Топология и размер под контролем

face_limit ограничивает число граней от 1 000 до 2 000 000, quad_mesh переключает на четырёхугольные полигоны для редактирования в программе моделирования, а geometry_quality: detailed тратит больше вычислений на мелкие детали поверхности. auto_size масштабирует сетку до реальных размеров, а model_orientation: align_image поворачивает её в соответствии с изображением.

Что мы измерили

При настройках по умолчанию фронтальный вид кожаного ботинка 1024×1024 вернулся через 167 секунд в виде GLB на 45,8 МБ с 1 471 382 треугольниками и тремя текстурами. Из-за такой плотности для всего, что показывается в браузере, нужно задавать face_limit.

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

Цены

Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.

Сценарии использования

Ассеты для игр, AR и сцен в реальном времени

Задайте face_limit по бюджету вашей сцены, включите quad_mesh, если ассет будут редактировать, и оставьте PBR включённым, чтобы модель реагировала на освещение сцены.

Визуализация товаров и печать

Для просмотрщика товаров оставляйте текстуры включёнными и используйте texture_quality: detailed, если надписи или строчки должны оставаться читаемыми. Для 3D-печати или скульптуры выключите оба переключателя текстур и задайте auto_size, чтобы сетка получилась в реальном масштабе.

Руководство по промптам и советы

Начните с чистого снимка

Один объект, полностью в кадре, на однотонном фоне. Ракурс три четверти даёт модели больше информации о глубине, чем прямой фронтальный вид. JPEG, PNG или WebP до 10 МБ.

Включайте только то, что нужно

Сделайте первый проход на настройках по умолчанию с face_limit и улучшайте только тот этап, который не справился.

Итерируйте с двумя seed

seed фиксирует геометрию, texture_seed — текстуру. Сохраните seed и меняйте texture_seed, чтобы опробовать новые поверхности на той же форме, или сохраните texture_seed, когда исследуете формы.

Проверьте скрытую сторону

Откройте GLB в просмотрщике и полностью поверните модель перед использованием. Если невидимая сторона выглядит неправильно, другой ракурс камеры в исходном изображении помогает больше, чем любая настройка.

Быстрый старт API

Вызов API Tripo H3.1 в три шага

1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
2. Отправьте запрос. Отправьте POST /jobs/createTask с model tripo/h3.1/image-to-3d и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
3. Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.

Вопросы об API Tripo H3.1

Другие API: изображения

• Seed3D 2.0 API3D-модели с богатыми текстурами по одному изображению, особенно персонажиОт 0,48 $ за генерацию

Ещё о Tripo H3.1

Попробовать

Tripo H3.1: нейросеть для картинок онлайнСоздавайте изображения с Tripo H3.1 в PopNow

Документация

ID модели и схема входных данных Tripo H3.1 в документации APIБыстрый старт с API PopNow: отправьте первый запросРуководство по генерации изображений через API PopNowВебхуки: результаты Tripo H3.1 без опроса