3D
TripoSG bild till 3D
Förvandla ett foto till ett 3D-nät som du kan ladda ner, även på en mobil.
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.
Modelllicenser
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-referens
Skicka via REST
Använd din personliga API-nyckel (msk_…) för att skapa jobb för den här arbetslasten från dina egna verktyg. Jobb som startas på det här sättet körs på samma enheter som du har anslutit under Dina enheter — minst en måste vara online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentisera med X-Organization-Api-Key: msk_your_personal_api_key. Huvudnamnet är detsamma som för organisationsnycklar; personliga nycklar använder samma slutpunkt.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign med samma API-nyckel, ladda upp din fil till den returnerade upload_url och skicka sedan download_url i job_spec (till exempel som input_image_url).Begärans brödtext
{
"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"
}
}Fält för job_spec
| Fält | Obligatoriskt | Standard | Beskrivning |
|---|---|---|---|
input_image_url | Ja | — | Ett foto eller en rendering av ett enda objekt. Motivet friläggs automatiskt, beskärs kvadratiskt och skalas om till 224x224, så ett enda tydligt motiv ger bäst geometri – röriga scener och flera objekt förvirrar friläggningen. En PNG som redan har transparens hoppar över friläggningssteget och är den mest tillförlitliga indatan av alla. |
remove_background | Nej | true | Kör segmenteringsmodellen när bilden inte har någon egen transparens. Stäng av detta för en bild som redan är en ren friläggning på vitt, eller när motivet fyller bilden. |
steps | Nej | 50 | Rectified-flow-steg. Under cirka 16 är formen igenkännbar men förlorar fin relief; över standardvärdet slutar den förändras. |
guidance_scale | Nej | 7 | Hur noga nätet följer referensbilden. |
seed | Nej | — | Slumpmässig seed för reproducerbar generering. |
grid_resolution | Nej | 192 | Upplösningen på fältet som ytan extraheras från. Kostnaden växer med kuben: 256 är ungefär 2,4 gånger så mycket arbete som standardvärdet, för en skillnad som mestadels inte överlever utjämningen. |
texture | Nej | true | Projicera fotot på nätet som en grundfärgstextur. Sidan som fotot visade blir skarp; baksidan är en utsmetning av den närmaste siluettens färg, eftersom en bild inte kan se den. Stäng av detta för ett enfärgat grått nät – mindre fil, och rätt val om du tänker texturera det själv. |
texture_upscale | Nej | false | Kör ett 4x superupplösningspass över motivet innan det projiceras. Lönar sig bara när motivet är litet i bilden – texturen byggs i fotots egen upplösning, så ett stort tydligt foto har redan mer detalj än den rymmer och detta skulle bara skala upp vår egen nedskalning. Det hoppas över automatiskt när fotot är tillräckligt stort, så att låta det vara på kostar inget annat än en nedladdning. |
texture_upscaler | Nej | 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}Polla med samma API-nyckel tills status är slutgiltig (COMPLETED, FAILED, CANCELED eller MODERATION_BLOCKED). När innehållsmoderering är aktiverad kan jobb börja i MODERATION_PENDING innan de går in i beräkningskön. Slutförda jobb innehåller försignerade download_url-värden för varje utdata.
Svar vid skapande
{
"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"
}Svar vid slutförande
{
"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>"
}Ladda upp ett foto och ladda ner ett 3D-nät (GLB). Motivet friläggs från bakgrunden. Färgen kommer från fotot: sidan du fotograferade är skarp, baksidan är mjukare, och det finns inga metall- eller råhetskartor. Gratis bild till 3D på enheter du ansluter, även en mobil. Första körningen laddar ner modellen; senare foton startar snabbare. Avancerade alternativ stänger av friläggningen och texturen, och slår på en större textur när motivet är för litet i bilden.