Tripo
Tripo H3.1
tripo-h3.1/image-to-3d
Высокодетализированная модель генерации 3D от Tripo, поддерживающая создание текстурированных 3D-ассетов по текстовому запросу, одному изображению или нескольким видам, с настраиваемым числом полигонов и качеством текстур и выводом PBR-материалов; подходит для создания игровых предметов, визуализации продуктов и других ассетов
Попробовать tripo-h3.1/image-to-3d
Ввод
Загрузите фотографию одного объекта на чистом фоне в качестве входных данных для генерации. Поддерживаются только JPG, PNG, WEBP.
Вывод
Цены
tripo-h3.1/image-to-3d per model
+ $0.290 более детальная геометрия · при выборе детальное
Что это такое
Инструмент для разработчиков и дизайн-команд, которым нужно быстро создавать трёхмерные ассеты из одной фотографии. Достаточно передать HTTPS-ссылку на изображение объекта на чистом фоне, и на выходе получается трёхмерная модель с геометрией и опциональной текстурой — удобно быстро превращать фотографии реальных предметов в цифровые ассеты для просмотра, рендеринга или дальнейшего редактирования.
Ключевые возможности
- Трёхмерная модель из одного изображения — для запуска генерации достаточно ссылки на фотографию объекта на чистом фоне; подходит для быстрой оцифровки реальных предметов или дизайн-макетов.
- Раздельное управление геометрией и текстурой — можно одновременно отключить текстуру и PBR и получить только геометрическую сетку, а также отдельно задать уровни качества геометрии и текстуры в зависимости от задачи.
- Собственный лимит полигонов — можно указать целевое число треугольников от 1000 до 1,5 млн (до 2 млн при детализированной геометрии), чтобы адаптировать модель под конвейеры с разной точностью.
- Воспроизводимые результаты — для геометрии и текстуры можно задать случайное зерно; вместе с фиксированными параметрами это упрощает повторную генерацию и сравнение результатов.
Описание возможностей
Генерация трёхмерной сетки по изображению: на вход подаётся HTTPS-ссылка на одну фотографию объекта, на выходе — трёхмерная модель; если одновременно отключить текстуру и PBR, получится чистая геометрическая сетка — удобно сначала задать форму, а затем обработать её.
Управление целевым числом полигонов: параметр face_limit позволяет задать целевое число треугольников от 1000 до 1,5 млн (до 2 млн при детализированной геометрии); если не указан, модель выбирает его адаптивно, что удобно для соответствия требованиям точности при рендеринге или облегчении сцены.
Переключатели текстуры и PBR: текстура включена по умолчанию, и по умолчанию создаётся PBR-материал; при включённом PBR текстура создаётся принудительно, и только при отключении и текстуры, и PBR остаётся лишь геометрия — выбирайте по назначению в дальнейшем конвейере.
Переключение уровней качества: для качества геометрии и качества текстуры доступны уровни standard или detailed; детализированный уровень даёт более тонкую детализацию сетки и текстуры более высокого разрешения соответственно.
Ориентация и выравнивание текстуры: параметр orientation со значением «по входному изображению» (align_image) автоматически поворачивает модель в соответствии с исходной картинкой; параметр texture_alignment позволяет выровнять текстуру по исходному изображению или по геометрии.
Сценарии применения
- Фотографии реальных предметов в цифровые ассеты — команды электронной коммерции или дизайна генерируют трёхмерные модели по фотографиям предметов в руках и размещают их на страницах товаров или в трёхмерных просмотрщиках, чтобы пользователи могли вращать модель.
- Быстрая материализация концепт-дизайна — концепт-дизайнеры превращают эскизы или референсы в трёхмерные сетки и используют их в программах моделирования как отправную точку для пропорций и объёмов.
- Трёхмерная основа для маркетинговых материалов — маркетинговые команды генерируют текстурированные модели по изображениям продуктов и импортируют их в конвейеры рендеринга или анимации для создания объёмных продуктовых материалов в рекламных изображениях.
- Предварительная генерация облегчённых ассетов — разработчики задают меньшее число полигонов и стандартную текстуру и пакетно создают трёхмерные ассеты для мобильных устройств или сценариев реального времени.
Ограничения и рекомендации по выбору
На вход принимается только HTTPS-ссылка на изображение одного объекта на чистом фоне; при загромождённом фоне или нескольких объектах в кадре не всегда удаётся получить желаемую геометрию. Целевое число полигонов ограничено диапазоном от 1000 до 1,5 млн (до 2 млн при детализированной геометрии) треугольников; при заниженном числе полигонов теряются детали. После отключения текстуры и PBR на выходе получается геометрия без материала. Настройки выравнивания текстуры и ориентации влияют на итоговый вид и должны выбираться с учётом входного изображения; результат генерации не гарантирует попиксельного совпадения с фотографией.
Новости
Смотреть 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/image-to-3d
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для tripo-h3.1/image-to-3d и маршрута default — см. таблицу параметров ниже.
pbrbooleanНеобязательноПо умолчанию: trueУправляет созданием PBR-материалов; при значении true дополнительно создаются текстурные карты. По умолчанию true.
texturebooleanНеобязательноПо умолчанию: trueСоздавать ли текстуры для модели, по умолчанию true. Обратите внимание: при pbr = true текстуры создаются принудительно; только если и texture, и pbr установлены в false, выводится чистая геометрическая сетка.
image_urlstringОбязательноpattern ^https://HTTPS-адрес фотографии одного объекта с чистым фоном, используется как входное изображение для генерации 3D по изображению.
face_limitintegerНеобязательноmin 1000max 2000000Целевое число треугольников, целое число в диапазоне 1000–1500000 (до 2000000 при geometry_quality=detailed); если не указано, число граней определяется моделью адаптивно, файл обычно получается крупным, для веб-отображения рекомендуется около 50000.
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/image-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_url": "…",
"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/image-to-3d",
input: {
"pbr": true,
"texture": true,
"image_url": "…",
"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/image-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_url": "…",
"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: три способа ввода, параметры и как выбрать тариф
Практическое руководство для разработчиков по принятию решений и контролю затрат при интеграции генерации 3D
-
Руководство
Практические сценарии Tripo H3.1: 5 высокоценных применений и ключевые моменты реализации
От text-to-3D до multiview-восстановления: выбирайте правильный режим и параметры под бизнес-сценарий
-
Сравнительный обзор
Tripo H3.1: сравнение и руководство по выбору — как выбрать из трёх путей 3D-генерации и как сэкономить
С точки зрения разработчика: выбор на основе типа входных данных, доработки геометрии и переключателей PBR/текстур, а также оценка цен и возможностей