3D
TripoSG: imagen a 3D
Convierta una foto en una malla 3D que puede descargar, también desde un teléfono.
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.
Licencias del 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.
Referencia de la API
Enviar mediante REST
Use su clave de API personal (msk_…) para crear trabajos de esta carga de trabajo desde sus propias herramientas. Los trabajos iniciados así se ejecutan en los mismos dispositivos que conectó en Sus dispositivos: al menos uno tiene que estar en línea.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentíquese con X-Organization-Api-Key: msk_your_personal_api_key. El nombre del encabezado coincide con el de las claves de organización; las claves personales usan el mismo endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign con la misma clave de API, suba su archivo a la upload_url devuelta y luego pase download_url en job_spec (por ejemplo, como input_image_url).Cuerpo de la solicitud
{
"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 | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|
input_image_url | Sí | — | Una foto o un render de un solo objeto. El sujeto se recorta automáticamente, se recorta a cuadrado y se redimensiona a 224x224, por lo que un único sujeto claro da la mejor geometría: las escenas recargadas y los objetos múltiples confunden el recorte. Un PNG que ya tiene transparencia se salta el paso de recorte y es la entrada más fiable de todas. |
remove_background | No | true | Ejecuta el modelo de segmentación cuando la imagen no tiene transparencia propia. Desactívelo para una imagen que ya es un recorte limpio sobre blanco, o cuando el sujeto llena el encuadre. |
steps | No | 50 | Pasos de rectified-flow. Por debajo de unos 16 la forma es reconocible pero pierde relieve fino; por encima del valor predeterminado deja de cambiar. |
guidance_scale | No | 7 | Cuánto sigue la malla a la imagen de referencia. |
seed | No | — | Semilla aleatoria para una generación reproducible. |
grid_resolution | No | 192 | Resolución del campo del que se extrae la superficie. El coste crece con el cubo: 256 supone aproximadamente 2,4 veces el trabajo del valor predeterminado, por una diferencia que en su mayor parte no sobrevive al suavizado. |
texture | No | true | Proyecta la foto sobre la malla como textura de color base. El lado que mostraba la foto sale nítido; el lado oculto es un difuminado del color de silueta más cercano, porque una sola imagen no puede verlo. Desactívelo para una malla gris lisa: archivo más pequeño y la opción adecuada si va a texturizarla usted mismo. |
texture_upscale | No | false | Ejecuta una pasada de superresolución 4x sobre el sujeto antes de proyectarlo. Solo vale la pena cuando el sujeto es pequeño en el encuadre: la textura se construye con la resolución propia de la foto, así que una foto grande y clara ya tiene más detalle del que contiene y esto solo ampliaría nuestra propia reducción. Se omite automáticamente cuando la foto es lo bastante grande, por lo que dejarlo activado no cuesta más que una descarga. |
texture_upscaler | No | 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 periódicamente con la misma clave de API hasta que status sea final (COMPLETED, FAILED, CANCELED o MODERATION_BLOCKED). Cuando la moderación de contenido está habilitada, los trabajos pueden empezar en MODERATION_PENDING antes de entrar en la cola de cómputo. Los trabajos completados incluyen valores download_url prefirmados en cada salida.
Respuesta de creación
{
"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"
}Respuesta de trabajo completado
{
"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>"
}Suba una foto y descargue una malla 3D (GLB). El sujeto se recorta del fondo. El color procede de la foto: el lado que fotografió es nítido, el lado oculto es más suave y no hay mapas de metalicidad ni de rugosidad. Imagen a 3D gratis en los dispositivos que conecte, incluido un teléfono. La primera ejecución descarga el modelo; las siguientes fotos empiezan más rápido. Las opciones avanzadas desactivan el recorte y la textura, y activan una textura mayor cuando el sujeto es demasiado pequeño en el encuadre.