Создаёт лёгкую low-poly 3D-модель по фото, по описанию или упрощает готовую модель — для игр, AR и сайтов. Цена — 30 ₽ за модель.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Hyper3D Low Poly делает лёгкие 3D-модели с небольшим числом полигонов - от 200 до 10 000 граней. Такие модели быстро грузятся в браузере и на телефоне, не тормозят в игровом движке и легко правятся в 3D-редакторе. Через API её удобно запускать для:
Нейросеть работает в трёх режимах: по 1-5 фото предмета, по текстовому описанию и из готовой 3D-модели. Каждый вызов создаёт асинхронную операцию: в ответ сразу приходят id и стартовый статус, а ссылку на готовый файл вы забираете запросом проверки статуса.
POST /api/v1/operationsAuthorization: Bearer brth_...id, стартовый статус и стоимость.Режим задаётся полем generation_type:
image - модель по фотографиям: image_urls (1-5 ссылок) и при желании prompt_image;text - модель по описанию: prompt_text;mesh - упрощение готовой модели: model_url.Число полигонов, тип сетки и формат файла работают во всех режимах. Материалы и настройки текстур - в режимах image и text, перенос текстур исходника - в режиме mesh.
Базовая форма запроса:
{
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "image",
"...": "..."
}
}
tool - slug нейросети, для этой модели всегда "hyper3d-lowpoly".input - параметры запуска. Поля передаются прямо внутри input, без дополнительной вложенности.generation_type и поле с исходником своего режима: image_urls, prompt_text или model_url. Остальные параметры можно не передавать - тогда используются значения по умолчанию из таблицы ниже. Поля чужого режима игнорируются.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
generation_type | enum | Да | Режим: image - по фото, text - по описанию, mesh - упростить готовую модель. |
prompt_text | string | Да, в режиме text | Описание предмета или персонажа, от 2 до 1024 символов. Лучше всего работают конкретные описания одного объекта: что это, из чего сделано, какие цвета и детали. |
prompt_image | string | Нет | Только в режиме image. Подсказка о том, чего не видно на фото, например материал или цвет обратной стороны. До 1024 символов. Можно не передавать. |
image_urls | string[] (url) | Да, в режиме image | Фотографии предмета, от 1 до 5 штук. Только внешние http/https URL. Расширения: .jpg, .jpeg, .png, .webp. Несколько ракурсов одного предмета дают более точную форму. |
model_url | string (url) | Да, в режиме mesh | Ссылка на модель для упрощения. Только внешний http/https URL. Расширения: .glb, .obj, .fbx, .stl. |
face_count | number | Нет | Число полигонов в результате, от 200 до 10 000. Меньше - легче файл и проще форма, больше - точнее мелкие детали. Если не передать, используется 4000. |
mesh_mode | enum | Нет | Тип сетки: Quad - четырёхугольники, удобно править и анимировать в 3D-редакторе; Raw - треугольники, понимает любой движок и программа для 3D-печати; NGon - многоугольники. Если не передать, используется Quad. |
geometry_file_format | enum | Нет | Формат файла: glb, fbx, obj, usdz или . В GLB, FBX и USDZ текстуры встроены в файл, у OBJ приходят отдельными картинками, STL - только форма без цвета. Если не передать, используется . |
Два ракурса игрушки, 3000 полигонов, PBR-материалы.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "image",
"image_urls": [
"https://cdn.example.com/toy-front.jpg",
"https://cdn.example.com/toy-side.jpg"
],
"prompt_image": "Игрушка из матового пластика, спина гладкая, без надписей",
"face_count": 3000,
"material": "PBR",
"geometry_file_format": "glb"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'hyper3d-lowpoly',
input: {
generation_type: 'image',
image_urls: [
'https://cdn.example.com/toy-front.jpg',
'https://cdn.example.com/toy-side.jpg',
],
prompt_image: 'Игрушка из матового пластика, спина гладкая, без надписей',
face_count: 3000,
material: 'PBR',
geometry_file_format: 'glb',
},
}),
})
const operation = await response.json()
console.log(operation.id, operation.status)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "image",
"image_urls": [
"https://cdn.example.com/toy-front.jpg",
"https://cdn.example.com/toy-side.jpg",
],
"prompt_image": "Игрушка из матового пластика, спина гладкая, без надписей",
"face_count": 3000,
"material": "PBR",
"geometry_file_format": "glb",
},
},
)
operation = response.json()
print(operation["id"], operation["status"])
Игровой предмет в FBX с четырёхугольной сеткой и детальными текстурами.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "text",
"prompt_text": "Деревянный сундук с железными уголками и висячим замком, стилизованный, яркие цвета",
"face_count": 2000,
"mesh_mode": "Quad",
"texture_mode": "high",
"geometry_file_format": "fbx"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'hyper3d-lowpoly',
input: {
generation_type: 'text',
prompt_text:
'Деревянный сундук с железными уголками и висячим замком, стилизованный, яркие цвета',
face_count: 2000,
mesh_mode: 'Quad',
texture_mode: 'high',
geometry_file_format: 'fbx',
},
}),
})
const operation = await response.json()
console.log(operation.id, operation.status)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "text",
"prompt_text": "Деревянный сундук с железными уголками и висячим замком, стилизованный, яркие цвета",
"face_count": 2000,
"mesh_mode": "Quad",
"texture_mode": "high",
"geometry_file_format": "fbx",
},
},
)
operation = response.json()
print(operation["id"], operation["status"])
Тяжёлая модель ужимается до 1500 треугольников с переносом текстур.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "mesh",
"model_url": "https://cdn.example.com/scanned-chair.glb",
"face_count": 1500,
"mesh_mode": "Raw",
"transfer_texture": true,
"geometry_file_format": "glb"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'hyper3d-lowpoly',
input: {
generation_type: 'mesh',
model_url: 'https://cdn.example.com/scanned-chair.glb',
face_count: 1500,
mesh_mode: 'Raw',
transfer_texture: true,
geometry_file_format: 'glb',
},
}),
})
const operation = await response.json()
console.log(operation.id, operation.status)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "hyper3d-lowpoly",
"input": {
"generation_type": "mesh",
"model_url": "https://cdn.example.com/scanned-chair.glb",
"face_count": 1500,
"mesh_mode": "Raw",
"transfer_texture": True,
"geometry_file_format": "glb",
},
},
)
operation = response.json()
print(operation["id"], operation["status"])
{
"id": "3f8a2c61-9b4e-4d17-a5c2-6e0b1d7f9a84",
"status": "queued",
"tool": "hyper3d-lowpoly",
"cost": 30,
"balance_after": 470,
"created_at": "2026-11-19T10:00:00.000Z"
}
{
"id": "3f8a2c61-9b4e-4d17-a5c2-6e0b1d7f9a84",
"status": "completed",
"tool": "hyper3d-lowpoly",
"cost": 30,
"created_at": "2026-11-19T10:00:00.000Z",
"completed_at": "2026-11-19T10:01:42.000Z",
"result": {
"type": "file",
"files": [
{
"url": "https://storage.bratuha.ru/results/hyper3d-lowpoly/model.glb",
"name": "result"
}
]
},
"error_message": null
}
{
"id": "3f8a2c61-9b4e-4d17-a5c2-6e0b1d7f9a84",
"status": "failed",
"tool": "hyper3d-lowpoly",
"cost": 30,
"created_at": "2026-11-19T10:00:00.000Z",
"completed_at": "2026-11-19T10:00:20.000Z",
"result": null,
"error_message": "Не удалось выполнить операцию"
}
Статус проверяется по id, который пришёл в ответ на создание операции. Сохраните его - без id результат конкретного запуска не получить. Модель строится дольше картинки, поэтому опрашивать удобно раз в 5-10 секунд, пока статус не станет completed или failed.
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/3f8a2c61-9b4e-4d17-a5c2-6e0b1d7f9a84
const operationId = '3f8a2c61-9b4e-4d17-a5c2-6e0b1d7f9a84'
const response = await fetch(
`https://bratuha.ru/api/v1/operations/${operationId}`,
{
headers: {
Authorization: 'Bearer brth_ваш_ключ',
},
},
)
const operation = await response.json()
console.log(operation)
После успешного выполнения в result приходит объект с типом file и массивом files. В каждом элементе - ссылка url и имя name.
3D-модель, за ним отдельные картинки текстур с именами Текстура 1, Текстура 2 и так далее.{
"type": "file",
"files": [
{ "url": "https://storage.bratuha.ru/results/hyper3d-lowpoly/model.obj", "name": "3D-модель" },
{ "url": "https://storage.bratuha.ru/results/hyper3d-lowpoly/texture-1.png", "name": "Текстура 1" }
]
}
Цена фиксированная - 30 ₽ за одну модель в любом режиме. Число полигонов, формат файла, материалы и качество текстур на стоимость не влияют. Сумма списывается при создании операции и видна в поле cost ответа.
POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги заново. Если ответ не пришёл из-за обрыва связи, сначала проверьте список операций, а потом повторяйте.GET /api/v1/operations/{id}.http/https ссылками, которые открываются без авторизации.image лучше всего подходят фото одного предмета на простом фоне, где он занимает большую часть кадра. Несколько ракурсов одного предмета дают более точную форму, чем один снимок.face_count.material = None.mesh модель лучше подготовить заранее: один объект, текстуры встроены в файл (для GLB и FBX).stlglbmaterial | enum | Нет | Только в режимах image и text. Shaded - цвет с запечёнными тенями, модель хорошо выглядит сразу; PBR - реалистичные материалы, которые реагируют на свет в движке; None - только форма, без текстур. Если не передать, используется Shaded. |
texture_mode | enum | Нет | Только в режимах image и text, если material не None. Детализация текстур: extreme-low, low, medium, high, extreme-high. Чем выше, тем больше мелких деталей и дольше генерация. extreme-high даёт текстуры 6K, а с resolution = High - 12K. Если не передать, используется medium. |
resolution | enum | Нет | Разрешение текстур: Basic - 2K, High - 4K. В режиме mesh работает только при переносе текстур. Если не передать, используется Basic. |
uhd_texture | boolean | Нет | Только в режимах image и text. true - удвоить разрешение текстур, чтобы мелкие детали были чётче. С texture_mode = extreme-high ничего не меняет. Если появятся артефакты, выключите. По умолчанию false. |
transfer_texture | boolean | Нет | Только в режиме mesh. true - перенести цвета исходной модели на упрощённую, false - вернуть только форму. По умолчанию true. |