3D
TripoSG Imagem para 3D
Transforme uma foto em uma malha 3D que você pode baixar, inclusive em um celular.
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.
Licenças do modelo
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.
Referência da API
Enviar via REST
Use sua chave de API pessoal (msk_…) para criar tarefas desta carga de trabalho a partir das suas próprias ferramentas. As tarefas iniciadas dessa forma rodam nos mesmos dispositivos que você conectou em Seus dispositivos — pelo menos um deles precisa estar online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentique-se com X-Organization-Api-Key: msk_your_personal_api_key. O nome do cabeçalho é o mesmo das chaves de organização; as chaves pessoais usam o mesmo endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign com a mesma chave de API, envie seu arquivo para o upload_url retornado e depois passe download_url em job_spec (por exemplo, como input_image_url).Corpo da solicitação
{
"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"
}
}Campos de job_spec
| Campo | Obrigatório | Padrão | Descrição |
|---|---|---|---|
input_image_url | Sim | — | Uma foto ou renderização de um único objeto. O assunto é recortado automaticamente, cortado em formato quadrado e redimensionado para 224x224, então um único assunto bem definido dá a melhor geometria — cenas cheias e vários objetos confundem o recorte. Um PNG que já tem transparência dispensa a etapa de recorte e é a entrada mais confiável de todas. |
remove_background | Não | true | Executa o modelo de segmentação quando a imagem não tem transparência própria. Desative para uma imagem que já é um recorte limpo sobre fundo branco ou quando o assunto preenche o quadro. |
steps | Não | 50 | Passos de rectified-flow. Abaixo de cerca de 16 a forma é reconhecível, mas perde o relevo fino; acima do padrão, deixa de mudar. |
guidance_scale | Não | 7 | O quanto a malha segue a imagem de referência. |
seed | Não | — | Seed aleatória para geração reproduzível. |
grid_resolution | Não | 192 | Resolução do campo do qual a superfície é extraída. O custo cresce com o cubo: 256 dá cerca de 2,4x o trabalho do padrão, para uma diferença que em geral não sobrevive à suavização. |
texture | Não | true | Projeta a foto na malha como textura de cor base. O lado mostrado na foto fica nítido; o lado oposto é um borrão da cor da silhueta mais próxima, porque uma única imagem não o enxerga. Desative para uma malha cinza lisa — arquivo menor e a escolha certa se você for texturizá-la por conta própria. |
texture_upscale | Não | false | Executa uma passagem de super-resolução 4x sobre o assunto antes de projetá-lo. Só vale a pena quando o assunto é pequeno no quadro — a textura é construída na resolução da própria foto, então uma foto grande e nítida já tem mais detalhe do que ela comporta, e isso apenas ampliaria a nossa própria redução. É ignorada automaticamente quando a foto é grande o bastante, então deixá-la ativada só custa um download. |
texture_upscaler | Não | 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}Consulte com a mesma chave de API até que status seja final (COMPLETED, FAILED, CANCELED ou MODERATION_BLOCKED). Quando a moderação de conteúdo está habilitada, as tarefas podem começar em MODERATION_PENDING antes de entrar na fila de computação. As tarefas concluídas incluem valores download_url pré-assinados em cada saída.
Resposta de criação
{
"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"
}Resposta de conclusão
{
"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>"
}Envie uma foto e baixe uma malha 3D (GLB). O assunto é recortado do fundo. A cor vem da foto: o lado que você fotografou fica nítido, o lado oposto fica mais suave, e não há mapas metálicos nem de rugosidade. Imagem para 3D grátis nos dispositivos que você conecta, inclusive um celular. A primeira execução baixa o modelo; as fotos seguintes começam mais rápido. As opções avançadas desativam o recorte e a textura, e ativam uma textura maior quando o assunto fica pequeno demais no quadro.