Tripo
Tripo H3.1
tripo-h3.1/multiview-to-3d
Высокодетализированная модель генерации 3D от Tripo, поддерживающая создание текстурированных 3D-ассетов по текстовому запросу, одному изображению или нескольким видам, с настраиваемым числом полигонов и качеством текстур и выводом PBR-материалов; подходит для создания игровых предметов, визуализации продуктов и других ассетов
Попробовать tripo-h3.1/multiview-to-3d
Ввод
Загрузите изображения одного и того же объекта с разных ракурсов по порядку: вид спереди (обязательно), вид слева, вид сзади, вид справа; не менее 2 и не более 4 изображений; поддерживаются только JPG, PNG, WEBP.
Вывод
Цены
tripo-h3.1/multiview-to-3d per model
+ $0.290 более детальная геометрия · при выборе детализированное
Введение
Инструмент генерации трёхмерных моделей по нескольким видам: принимает от 2 до 4 изображений одного объекта с разных ракурсов и создаёт трёхмерный ресурс с геометрической структурой. Входные изображения передаются в порядке спереди, слева, сзади и справа; инструмент подходит специалистам по игровой графике и визуализации продуктов, у которых есть фотографии продукта или круговые снимки, и позволяет быстро превращать реальные объекты или дизайн-макеты в трёхмерные модели, которые можно дальше редактировать, рендерить или экспортировать.
Ключевые возможности
- Геометрия, ограниченная несколькими видами — можно строить модель совместно по 2–4 изображениям одного объекта с разных ракурсов, что задаёт контур формы точнее, чем одно изображение.
- Настраиваемая детализация геометрии и текстуры — качество геометрии и качество текстуры можно выбрать из двух уровней: стандартного или детального (standard / detailed), выбирая между скоростью и детализацией в зависимости от задачи.
- Гибкое управление материалами и числом полигонов — можно включать или отключать текстуры и PBR-материалы, а также задавать целевое число треугольников от 1000 до 1,5 млн (до 2 млн при детальной геометрии).
- Управление ориентацией и воспроизводимостью — ориентацию можно выровнять по входным изображениям, для геометрии и текстуры задаются отдельные случайные зерна, что упрощает фиксацию результата.
Описание возможностей
Моделирование по нескольким видам: передайте 2–4 HTTPS-изображения, описывающих один объект в порядке спереди, слева, сзади и справа, чтобы сгенерировать соответствующий трёхмерный ресурс.
Текстуры и PBR-материалы: по умолчанию создаются текстуры и PBR-материалы; можно одновременно отключить текстуру и PBR, оставив только чисто геометрическую сетку; качество текстуры выбирается из стандартного или детального уровня.
Ограничение числа полигонов: можно задать целевое число треугольников от 1000 до 1,5 млн (до 2 млн при детальной геометрии); если не указывать, модель выбирает его адаптивно, что упрощает подгонку под бюджет нижестоящего конвейера.
Ориентация и выравнивание: при выборе ориентации «выровнять по входному изображению» (align_image) модель автоматически поворачивается, чтобы соответствовать входному изображению; выравнивание текстуры (texture_alignment) можно настроить либо по исходному изображению, либо по геометрии.
Воспроизведение по случайному зерну: для геометрии и текстуры отдельно задаются целочисленные зёрна, что помогает воспроизводить результат при одинаковых входных данных и настройках.
Сценарии применения
- Круговые фотографии продукта в трёхмерные ресурсы — команды электронной коммерции или продуктовые команды используют многоракурсные фотографии продукта как входные данные и получают текстурированную трёхмерную модель для трёхмерной витрины на веб-сайте или маркетинговых иллюстраций.
- Прототипы для игр и графики сцен — художники генерируют сетку средней плотности по многовидовым дизайн-макетам персонажей или предметов и импортируют её в движок как ресурс для крупных планов или концепт-проверки.
- Упорядочивание сканов и референсы для ретопологии — команды цифровых ресурсов создают текстурированную эталонную модель по многовидовым сканам и используют её как базовую модель для сравнения при ручном восстановлении или создании материалов.
Ограничения и рекомендации по выбору
Изображения должны быть по HTTPS-адресам; в каждом запросе необходимо передать от 2 до 4 видов одного объекта, при меньшем или большем количестве запрос не принимается. Целевое число треугольников ограничено диапазоном от 1000 до 1,5 млн (до 2 млн при детальной геометрии); чем выше число полигонов, тем выше требования к производительности последующей обработки. Текстуры и PBR-материалы можно отключить одновременно, после чего выводится только чисто геометрическая сетка; детальный (detailed) уровень добавляет детали, но увеличивает время обработки. Случайное зерно только помогает воспроизводить результат и не гарантирует полной идентичности при многократной генерации.
Новости
Смотреть changelog →- Новая модель tripo-h3.1/multiview-to-3d запущена: Tripo H3.1 — генерация 3D по нескольким видам
- Новая модель tripo-h3.1/text-to-3d запущен: Tripo H3.1 преобразование текста в 3D
- Новая модель tripo-h3.1/image-to-3d теперь доступен: Tripo H3.1 — генерация 3D-моделей по изображению
Частые вопросы
Все частые вопросы →-
Каков верхний предел числа полигонов, можно ли достичь 2 миллионов?
Да, верхний предел face_limit составляет 2 миллиона треугольников, но реально 2 миллиона поддерживаются только при geometry_quality, установленном в detailed; при standard рекомендуется задавать не более 1,5 миллиона. Если face_limit не передан, модель сама адаптивно определяет число полигонов.
-
Как получить только геометрию без текстур?
Просто установите для texture и pbr значение false; при pbr = true текстуры будут генерироваться принудительно. Если нужны текстуры, но без PBR-материалов, установите texture = true, а pbr = false.
-
Нужно ли отдельно включать параметры для высокоплотной геометрии?
Если установить для geometry_quality значение detailed, будут добавлены более детальные детали сетки, и это также является условием, при котором число полигонов может достигать 2 миллионов; если нужны более детализированные текстуры, установите для texture_quality значение detailed. По умолчанию оба параметра имеют значение standard — включайте их в зависимости от требований к крупному плану целевого ассета.
-
Как воспроизвести результат генерации, чтобы было удобно сравнивать разные параметры?
У геометрии и текстуры есть собственные фиксированные сиды: model_seed управляет геометрией, texture_seed управляет текстурой, а при генерации 3D по тексту дополнительно есть image_seed, управляющий концепт-изображением. При сравнении параметров сначала фиксируйте сиды и меняйте только один параметр — тогда можно понять, из-за чего именно возникло различие.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: tripo-h3.1/multiview-to-3d
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для tripo-h3.1/multiview-to-3d и маршрута default — см. таблицу параметров ниже.
pbrbooleanНеобязательноПо умолчанию: trueСледует ли генерировать PBR-текстуры материалов; при значении true одновременно создаются текстурные карты, по умолчанию true.
texturebooleanНеобязательноПо умолчанию: trueСледует ли генерировать текстуры для модели, по умолчанию true. Обратите внимание: если pbr равно true, текстуры создаются принудительно; чистая геометрическая сетка выводится только когда и texture, и pbr установлены в false.
face_limitintegerНеобязательноmin 1000max 2000000Целевое число треугольных граней, целое число, диапазон 1000–1500000 (при geometry_quality=detailed — до 2000000); если не указано, модель адаптивно определяет число граней, файл обычно получается крупным, для отображения в веб-интерфейсе рекомендуется около 50000.
image_urlsarrayОбязательноminItems 2maxItems 4Массив HTTPS-URL из 2–4 изображений одного объекта с разных ракурсов, упорядоченных как спереди, слева, сзади, справа; первое изображение должно быть видом спереди.
Array [ string ]
model_seedintegerНеобязательноСлучайное зерно генерации геометрии, целое число, используется для воспроизведения одного и того же геометрического результата.
orientationstringНеобязательноПо умолчанию: "default"Настройка ориентации модели, строковое значение; при значении align_image модель автоматически поворачивается для выравнивания по входному изображению, по умолчанию default.
defaultalign_imagetexture_seedintegerНеобязательноСлучайное зерно генерации текстуры, целое число, используется для воспроизведения одного и того же результата текстурирования.
texture_qualitystringНеобязательноПо умолчанию: "standard"Уровень качества текстуры, строковое значение; уровень detailed создаёт текстуры более высокого разрешения, по умолчанию standard.
standarddetailedgeometry_qualitystringНеобязательноПо умолчанию: "standard"Уровень качества геометрии, строковое значение; уровень detailed обеспечивает более тонкую детализацию сетки, по умолчанию standard.
standarddetailedtexture_alignmentstringНеобязательноПо умолчанию: "original_image"Способ выравнивания текстуры по входному изображению, строковое значение, по умолчанию original_image.
original_imagegeometrycallbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1/multiview-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tripo-h3.1/multiview-to-3d",
input: {
"pbr": true,
"texture": true,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "tripo-h3.1/multiview-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Практические сценарии Tripo H3.1: 5 высокоценных применений и ключевые моменты реализации
От text-to-3D до multiview-восстановления: выбирайте правильный режим и параметры под бизнес-сценарий
-
Сравнительный обзор
Tripo H3.1: сравнение и руководство по выбору — как выбрать из трёх путей 3D-генерации и как сэкономить
С точки зрения разработчика: выбор на основе типа входных данных, доработки геометрии и переключателей PBR/текстур, а также оценка цен и возможностей
-
Руководство по использованию
Руководство по началу работы с Tripo H3.1: три способа ввода, параметры и как выбрать тариф
Практическое руководство для разработчиков по принятию решений и контролю затрат при интеграции генерации 3D