3D
TripoSG : image vers 3D
Transformez une photo en maillage 3D à télécharger, y compris sur un téléphone.
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.
Licences du modèle
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.
Référence de l’API
Envoyer via REST
Utilisez votre clé API personnelle (msk_…) pour créer des tâches pour ce workload depuis vos propres outils. Les tâches lancées ainsi s’exécutent sur les mêmes appareils que ceux que vous avez connectés dans Vos appareils ; au moins l’un d’eux doit être en ligne.
https://cp.meshlabs.cloud/v1/organizations/jobsAuthentifiez-vous avec X-Organization-Api-Key: msk_your_personal_api_key. Le nom de l’en-tête est le même que pour les clés d’organisation ; les clés personnelles utilisent le même point de terminaison.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign avec la même clé API, envoyez votre fichier vers l’upload_url renvoyée, puis transmettez download_url dans job_spec (par exemple en tant que input_image_url).Corps de la requête
{
"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"
}
}Champs de job_spec
| Champ | Requis | Par défaut | Description |
|---|---|---|---|
input_image_url | Oui | — | Une photo ou un rendu d'un seul objet. Le sujet est détouré automatiquement, recadré en carré et redimensionné en 224x224 : un seul sujet net donne donc la meilleure géométrie, car les scènes chargées et les objets multiples perturbent le détourage. Un PNG qui a déjà de la transparence saute l'étape de détourage et reste l'entrée la plus fiable. |
remove_background | Non | true | Exécute le modèle de segmentation lorsque l'image n'a pas de transparence propre. Désactivez pour une image déjà détourée proprement sur fond blanc, ou lorsque le sujet remplit le cadre. |
steps | Non | 50 | Étapes de rectified flow. En dessous d'environ 16, la forme reste reconnaissable mais perd le relief fin ; au-delà de la valeur par défaut, elle ne change plus. |
guidance_scale | Non | 7 | Degré de fidélité du maillage à l'image de référence. |
seed | Non | — | Graine aléatoire pour une génération reproductible. |
grid_resolution | Non | 192 | Résolution du champ à partir duquel la surface est extraite. Le coût croît avec le cube : 256 représente environ 2,4 fois le travail de la valeur par défaut, pour une différence qui ne survit généralement pas au lissage. |
texture | Non | true | Projette la photo sur le maillage comme texture de couleur de base. Le côté montré par la photo ressort net ; la face cachée est un étalement de la couleur de silhouette la plus proche, car une seule image ne peut pas la voir. Désactivez pour un maillage gris uni : fichier plus léger, et bon choix si vous comptez le texturer vous-même. |
texture_upscale | Non | false | Exécute une passe de super-résolution 4x sur le sujet avant de le projeter. N'a d'intérêt que lorsque le sujet est petit dans le cadre : la texture est construite à la résolution propre de la photo, donc une grande photo nette contient déjà plus de détails qu'elle n'en conserve, et cette passe ne ferait qu'agrandir notre propre réduction. Elle est ignorée automatiquement lorsque la photo est assez grande : la laisser activée ne coûte donc qu'un téléchargement. |
texture_upscaler | Non | 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}Interrogez l’API avec la même clé jusqu’à ce que status soit dans un état final (COMPLETED, FAILED, CANCELED ou MODERATION_BLOCKED). Lorsque la modération du contenu est activée, les tâches peuvent commencer à l’état MODERATION_PENDING avant d’entrer dans la file de calcul. Les tâches terminées incluent des valeurs download_url présignées pour chaque sortie.
Réponse de création
{
"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"
}Réponse de fin d’exécution
{
"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>"
}Importez une photo et téléchargez un maillage 3D (GLB). Le sujet est détouré de l'arrière-plan. La couleur provient de la photo : le côté photographié est net, la face cachée est plus douce, et il n'y a ni carte métallique ni carte de rugosité. Image vers 3D gratuit sur les appareils que vous connectez, y compris un téléphone. La première exécution télécharge le modèle ; les photos suivantes démarrent plus vite. Les options avancées permettent de désactiver le détourage et la texture, et d'activer une texture plus grande lorsque le sujet est trop petit dans le cadre.