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.

Licence fournie

Mention légale

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.

Licence fournie

Mention légale

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.

Licence fournie

Mention légale

GratuitEn ligneIllimitéUltraSharp Accès API

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.

Masquer les détails de l’API
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

Authentifiez-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.

Fichiers d’entrée :Appelez 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

ChampRequisPar défautDescription
input_image_urlOui—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_backgroundNontrueExé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.
stepsNon50É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_scaleNon7Degré de fidélité du maillage à l'image de référence.
seedNon—Graine aléatoire pour une génération reproductible.
grid_resolutionNon192Ré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.
textureNontrueProjette 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_upscaleNonfalseExé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_upscalerNonultrasharpUltraSharp: 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"
  }
}'
GEThttps://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.