3D
TripoSG afbeelding naar 3D
Zet één foto om in een 3D-mesh die u kunt downloaden, ook op een telefoon.
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.
Modellicenties
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-referentie
Indienen via REST
Gebruik uw persoonlijke API-sleutel (msk_…) om vanuit uw eigen tools taken voor deze workload aan te maken. Taken die op deze manier worden gestart, draaien op dezelfde apparaten die u hebt gekoppeld op Uw apparaten — ten minste één daarvan moet online zijn.
https://cp.meshlabs.cloud/v1/organizations/jobsAuthenticeer met X-Organization-Api-Key: msk_your_personal_api_key. De headernaam is dezelfde als bij organisatiesleutels; persoonlijke sleutels gebruiken hetzelfde endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign aan met dezelfde API-sleutel, upload uw bestand naar de geretourneerde upload_url en geef vervolgens download_url mee in job_spec (bijvoorbeeld als input_image_url).Request-body
{
"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"
}
}Velden van job_spec
| Veld | Verplicht | Standaard | Beschrijving |
|---|---|---|---|
input_image_url | Ja | — | Een foto of render van één enkel object. Het onderwerp wordt automatisch uitgeknipt, vierkant bijgesneden en verkleind tot 224x224, dus één duidelijk onderwerp geeft de beste geometrie — drukke scènes en meerdere objecten brengen het uitknippen in de war. Een PNG die al transparantie heeft, slaat de uitknipstap over en is de betrouwbaarste invoer van allemaal. |
remove_background | Nee | true | Voer het segmentatiemodel uit wanneer de afbeelding geen eigen transparantie heeft. Zet dit uit voor een afbeelding die al een schone uitsnede op wit is, of wanneer het onderwerp het hele beeld vult. |
steps | Nee | 50 | Rectified-flow-stappen. Onder ongeveer 16 is de vorm herkenbaar maar gaat fijn reliëf verloren; boven de standaard verandert er niets meer. |
guidance_scale | Nee | 7 | Hoe nauwkeurig de mesh de referentieafbeelding volgt. |
seed | Nee | — | Willekeurige seed voor reproduceerbare generatie. |
grid_resolution | Nee | 192 | Resolutie van het veld waaruit het oppervlak wordt gehaald. De kosten groeien met de derde macht: 256 is grofweg 2,4 keer zoveel werk als de standaard, voor een verschil dat grotendeels niet bestand is tegen gladstrijken. |
texture | Nee | true | Projecteer de foto als basiskleurtextuur op de mesh. De zijde die de foto toonde komt scherp uit; de achterzijde is een uitgesmeerde versie van de kleur van het dichtstbijzijnde silhouet, omdat één afbeelding die niet kan zien. Zet dit uit voor een kale grijze mesh — kleiner bestand, en de juiste keuze als u hem zelf gaat textureren. |
texture_upscale | Nee | false | Voer een 4x-superresolutiedoorgang uit over het onderwerp voordat het wordt geprojecteerd. Alleen de moeite waard wanneer het onderwerp klein in beeld staat — de textuur wordt opgebouwd op de eigen resolutie van de foto, dus een grote, duidelijke foto bevat al meer detail dan de textuur kan dragen en dit zou alleen onze eigen verkleining weer vergroten. Het wordt automatisch overgeslagen wanneer de foto groot genoeg is, dus aan laten staan kost niets behalve een download. |
texture_upscaler | Nee | 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}Poll met dezelfde API-sleutel totdat status een eindstatus heeft (COMPLETED, FAILED, CANCELED of MODERATION_BLOCKED). Wanneer inhoudsmoderatie is ingeschakeld, kunnen taken in MODERATION_PENDING starten voordat ze in de rekenwachtrij komen. Voltooide taken bevatten vooraf ondertekende download_url-waarden bij elke uitvoer.
Antwoord bij aanmaken
{
"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"
}Antwoord bij voltooiing
{
"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>"
}Upload één foto en download een 3D-mesh (GLB). Het onderwerp wordt van de achtergrond losgeknipt. De kleur komt uit de foto: de zijde die u hebt gefotografeerd is scherp, de achterzijde zachter, en er zijn geen metaal- of ruwheidsmaps. Gratis afbeelding naar 3D op apparaten die u verbindt, ook op een telefoon. De eerste keer wordt het model gedownload; latere foto's starten sneller. Met de geavanceerde opties schakelt u het uitknippen en de textuur uit, en een grotere textuur in wanneer het onderwerp te klein in beeld staat.