3D
TripoSG Bild zu 3D
Verwandeln Sie ein Foto in ein herunterladbares 3D-Mesh, auch auf einem Smartphone.
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.
Modelllizenzen
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-Referenz
Per REST übermitteln
Verwenden Sie Ihren persönlichen API-Schlüssel (msk_…), um aus Ihren eigenen Tools Jobs für diesen Workload zu erstellen. So gestartete Jobs laufen auf denselben Geräten, die Sie unter Ihre Geräte verbunden haben – mindestens eines muss online sein.
https://cp.meshlabs.cloud/v1/organizations/jobsAuthentifizieren Sie sich mit X-Organization-Api-Key: msk_your_personal_api_key. Der Header-Name entspricht dem der Organisationsschlüssel; persönliche Schlüssel verwenden denselben Endpunkt.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign mit demselben API-Schlüssel auf, laden Sie Ihre Datei an die zurückgegebene upload_url hoch und übergeben Sie dann download_url in job_spec (zum Beispiel als input_image_url).Anfrage-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"
}
}Felder von job_spec
| Feld | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
input_image_url | Ja | — | Ein Foto oder Rendering eines einzelnen Objekts. Das Motiv wird automatisch freigestellt, quadratisch zugeschnitten und auf 224x224 skaliert; ein einzelnes klares Motiv liefert daher die beste Geometrie – belebte Szenen und mehrere Objekte verwirren das Freistellen. Ein PNG, das bereits Transparenz hat, überspringt den Freistellschritt und ist die zuverlässigste Eingabe überhaupt. |
remove_background | Nein | true | Führt das Segmentierungsmodell aus, wenn das Bild keine eigene Transparenz hat. Schalten Sie dies für ein Bild aus, das bereits ein sauberer Freisteller auf Weiß ist, oder wenn das Motiv das Bild ausfüllt. |
steps | Nein | 50 | Rectified-Flow-Schritte. Unter etwa 16 ist die Form erkennbar, verliert aber feines Relief; über dem Standardwert ändert sie sich nicht mehr. |
guidance_scale | Nein | 7 | Wie genau das Mesh dem Referenzbild folgt. |
seed | Nein | — | Zufalls-Seed für reproduzierbare Generierung. |
grid_resolution | Nein | 192 | Auflösung des Feldes, aus dem die Oberfläche extrahiert wird. Der Aufwand wächst mit der dritten Potenz: 256 bedeutet etwa den 2.4-fachen Aufwand des Standardwerts für einen Unterschied, der das Glätten meist nicht übersteht. |
texture | Nein | true | Projiziert das Foto als Basisfarb-Textur auf das Mesh. Die vom Foto gezeigte Seite wird scharf; die Rückseite ist ein Verschmieren der nächstgelegenen Silhouettenfarbe, weil ein einzelnes Bild sie nicht sehen kann. Für ein schlichtes graues Mesh ausschalten – kleinere Datei und die richtige Wahl, wenn Sie es selbst texturieren möchten. |
texture_upscale | Nein | false | Führt vor der Projektion einen 4x-Super-Resolution-Durchlauf über das Motiv aus. Lohnt sich nur, wenn das Motiv im Bild klein ist – die Textur wird in der Eigenauflösung des Fotos aufgebaut, sodass ein großes klares Foto bereits mehr Details enthält, als es hält, und dies nur unsere eigene Verkleinerung hochskalieren würde. Es wird automatisch übersprungen, wenn das Foto groß genug ist, sodass Eingeschaltetlassen nichts außer einem Download kostet. |
texture_upscaler | Nein | 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}Fragen Sie mit demselben API-Schlüssel ab, bis status einen Endzustand erreicht (COMPLETED, FAILED, CANCELED oder MODERATION_BLOCKED). Ist die Inhaltsmoderation aktiviert, können Jobs in MODERATION_PENDING beginnen, bevor sie in die Compute-Warteschlange gelangen. Abgeschlossene Jobs enthalten für jede Ausgabe vorsignierte download_url-Werte.
Antwort beim Erstellen
{
"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"
}Antwort nach Abschluss
{
"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>"
}Laden Sie ein Foto hoch und laden Sie ein 3D-Mesh (GLB) herunter. Das Motiv wird vom Hintergrund freigestellt. Die Farbe stammt aus dem Foto: Die fotografierte Seite ist scharf, die Rückseite weicher, und es gibt keine Metallic- oder Roughness-Maps. Kostenlos Bild zu 3D auf Geräten, die Sie verbinden, auch auf einem Smartphone. Beim ersten Durchlauf wird das Modell heruntergeladen; spätere Fotos starten schneller. Erweiterte Optionen schalten das Freistellen und die Textur aus und eine größere Textur ein, wenn das Motiv im Bild zu klein ist.