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 на подключённых вами устройствах, включая телефон. При первом запуске скачивается модель; следующие фото стартуют быстрее. В расширенных параметрах можно отключить вырезание и текстуру, а также включить текстуру большего размера, если объект в кадре слишком мал.