3D
TripoSG – imagine în 3D
Transformați o fotografie într-o plasă 3D pe care o puteți descărca, inclusiv pe un telefon.
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.
Licențele modelului
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.
Referință API
Trimitere prin REST
Folosiți cheia API personală (msk_…) pentru a crea lucrări pentru această sarcină din propriile instrumente. Lucrările pornite astfel rulează pe aceleași dispozitive pe care le-ați conectat în Dispozitivele dvs. — cel puțin unul trebuie să fie online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentificați-vă cu X-Organization-Api-Key: msk_your_personal_api_key. Numele antetului este același ca pentru cheile organizației; cheile personale folosesc același endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign cu aceeași cheie API, încărcați fișierul la upload_url returnat, apoi transmiteți download_url în job_spec (de exemplu ca input_image_url).Corpul cererii
{
"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"
}
}Câmpurile job_spec
| Câmp | Obligatoriu | Implicit | Descriere |
|---|---|---|---|
input_image_url | Da | — | O fotografie sau o randare a unui singur obiect. Subiectul este decupat automat, decupat pătrat și redimensionat la 224x224, deci un singur subiect clar dă cea mai bună geometrie — scenele aglomerate și obiectele multiple încurcă decuparea. Un PNG care are deja transparență omite pasul de decupare și este cea mai sigură intrare dintre toate. |
remove_background | Nu | true | Rulați modelul de segmentare când imaginea nu are propria transparență. Dezactivați pentru o imagine care este deja o decupare curată pe alb sau când subiectul umple cadrul. |
steps | Nu | 50 | Pași rectified-flow. Sub aproximativ 16, forma este recognoscibilă, dar pierde relieful fin; peste valoarea implicită nu se mai schimbă. |
guidance_scale | Nu | 7 | Cât de fidel urmează plasa imaginea de referință. |
seed | Nu | — | Seed aleatoriu pentru generare reproductibilă. |
grid_resolution | Nu | 192 | Rezoluția câmpului din care se extrage suprafața. Costul crește cu cubul: 256 înseamnă aproximativ de 2,4 ori munca valorii implicite, pentru o diferență care în mare parte nu rezistă netezirii. |
texture | Nu | true | Proiectează fotografia pe plasă ca textură de culoare de bază. Partea arătată de fotografie iese clară; partea îndepărtată este o întindere a celei mai apropiate culori din siluetă, deoarece o singură imagine nu o poate vedea. Dezactivați pentru o plasă simplă, gri — fișier mai mic și alegerea potrivită dacă o veți texturi singur. |
texture_upscale | Nu | false | Rulează o trecere de super-rezoluție 4x peste subiect înainte de proiectare. Merită doar când subiectul este mic în cadru — textura este construită la rezoluția proprie a fotografiei, deci o fotografie mare și clară are deja mai mult detaliu decât conține, iar aceasta ar mări doar propria noastră reducere. Este omisă automat când fotografia este suficient de mare, deci lăsarea ei activată costă doar o descărcare. |
texture_upscaler | Nu | 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}Interogați cu aceeași cheie API până când status ajunge într-o stare finală (COMPLETED, FAILED, CANCELED sau MODERATION_BLOCKED). Când moderarea conținutului este activată, lucrările pot începe în MODERATION_PENDING înainte de a intra în coada de calcul. Lucrările finalizate includ valori download_url presemnate pentru fiecare rezultat.
Răspuns la creare
{
"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ăspuns la finalizare
{
"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>"
}Încărcați o fotografie și descărcați o plasă 3D (GLB). Subiectul este decupat din fundal. Culoarea provine din fotografie: partea pe care ați fotografiat-o este clară, partea îndepărtată este mai moale și nu există hărți metalice sau de rugozitate. Imagine în 3D gratuit, pe dispozitivele pe care le conectați, inclusiv pe un telefon. La prima rulare se descarcă modelul; fotografiile următoare pornesc mai repede. Opțiunile avansate dezactivează decuparea și textura și activează o textură mai mare atunci când subiectul este prea mic în cadru.