3D
TripoSG: зображення у 3D
Перетворіть одне фото на 3D-сітку, яку можна завантажити, зокрема на телефоні.
TripoSG by VAST-AI-Research; DINOv2 by Meta AI; U2-Net by Xuebin Qin and contributors; rembg by Daniel Gatis
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
Ліцензії моделі
TripoSG DiT and VAE ONNX derivatives · MIT
Preserve the complete MIT terms, copyright notice and disclaimer, and identify modifications. No upstream endorsement is granted.
DINOv2 Large conditioning image encoder · Apache-2.0
Preserve the complete Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.
U2-Net matte, rembg ONNX release · Apache-2.0 AND MIT
Preserve the complete applicable MIT/Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.
Real-ESRGAN x4plus original release ONNX derivative · BSD-3-Clause
Retain the original copyright notice, all three BSD conditions and warranty disclaimer with distributed copies. No endorsement using author/contributor names without permission.
Original 4x-UltraSharp ONNX conversion by Mesh · CC-BY-NC-SA-4.0
NonCommercial only. Preserve attribution, full license and modification notice. ShareAlike applies to adapted licensed material. Private compute only, unmetered, requester and operator acceptance required; no global-network execution. Acceptance does not grant commercial permission.
Довідник API
Надсилання через REST
Використовуйте свій особистий ключ API (msk_…), щоб створювати завдання для цього навантаження з власних інструментів. Завдання, запущені так, виконуються на тих самих пристроях, які ви під’єднали на сторінці Ваші пристрої, — принаймні один має бути в мережі.
https://cp.meshlabs.cloud/v1/organizations/jobsАвтентифікуйтеся за допомогою X-Organization-Api-Key: msk_your_personal_api_key. Назва заголовка така сама, як для ключів організації; особисті ключі використовують ту саму кінцеву точку.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign з тим самим ключем API, завантажте файл на повернутий upload_url, а потім передайте download_url у job_spec (наприклад, як input_image_url).Тіло запиту
{
"workload_type": "triposg-1-5b-i2m",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
}
}Поля job_spec
| Поле | Обов’язкове | За замовчуванням | Опис |
|---|---|---|---|
input_image_url | Так | — | Фото або рендер одного об’єкта. Об’єкт вирізається автоматично, обрізається до квадрата й масштабується до 224x224, тож найкращу геометрію дає один чіткий об’єкт — складні сцени й кілька об’єктів збивають вирізання. PNG, що вже має прозорість, пропускає крок вирізання й є найнадійнішим вхідним файлом. |
remove_background | Ні | true | Запустити модель сегментації, коли зображення не має власної прозорості. Вимкніть це для зображення, яке вже є чистим вирізом на білому тлі, або коли об’єкт займає весь кадр. |
steps | Ні | 50 | Кроки rectified-flow. Нижче приблизно 16 форма впізнавана, але втрачає дрібний рельєф; вище значення за замовчуванням вона перестає змінюватися. |
guidance_scale | Ні | 7 | Наскільки точно сітка слідує еталонному зображенню. |
seed | Ні | — | Випадкове значення seed для відтворюваної генерації. |
grid_resolution | Ні | 192 | Роздільна здатність поля, з якого витягується поверхня. Вартість зростає як куб: 256 — це приблизно в 2,4 раза більше роботи, ніж за замовчуванням, заради різниці, яка здебільшого не переживає згладжування. |
texture | Ні | true | Спроєктувати фото на сітку як текстуру базового кольору. Сторона, яку показало фото, виходить чіткою; дальня сторона — розмитий колір найближчого силуету, бо одне зображення її не бачить. Вимкніть це для простої сірої сітки — менший файл і правильний вибір, якщо ви збираєтеся текстурувати її самі. |
texture_upscale | Ні | false | Виконати 4x прохід суперроздільної здатності над об’єктом перед проєктуванням. Має сенс лише коли об’єкт у кадрі малий — текстура будується в роздільній здатності самого фото, тож велике чітке фото вже має більше деталей, ніж вміщує текстура, і це лише збільшило б наше ж зменшення. Автоматично пропускається, коли фото достатньо велике, тож залишити його ввімкненим коштує лише завантаження. |
texture_upscaler | Ні | ultrasharp | UltraSharp: preferred detail, private NonCommercial use with terms acceptance. x4plus: BSD-3-Clause alternative. Used only when sharpening a small photo is enabled. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "triposg-1-5b-i2m",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}Опитуйте з тим самим ключем API, доки status не стане кінцевим (COMPLETED, FAILED, CANCELED або MODERATION_BLOCKED). Коли ввімкнено модерацію вмісту, завдання можуть починатися в стані MODERATION_PENDING, перш ніж потрапити в чергу обчислень. Завершені завдання містять попередньо підписані значення download_url для кожного результату.
Відповідь на створення
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "triposg-1-5b-i2m",
"status": "PENDING",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}Відповідь після завершення
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "triposg-1-5b-i2m",
"status": "COMPLETED",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}Завантажте одне фото й отримайте 3D-сітку (GLB). Об’єкт вирізається з фону. Колір береться з фото: сторона, яку ви сфотографували, чітка, дальня сторона м’якша, а мап металічності чи шорсткості немає. Безкоштовне перетворення зображення на 3D на підключених вами пристроях, зокрема на телефоні. Під час першого запуску завантажується модель; наступні фото стартують швидше. Додаткові параметри вимикають вирізання та текстуру й вмикають більшу текстуру, коли об’єкт у кадрі замалий.