3D
TripoSG Εικόνα σε 3D
Μετατρέψτε μία φωτογραφία σε τρισδιάστατο mesh που μπορείτε να κατεβάσετε, μεταξύ άλλων σε κινητό.
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.
Άδειες μοντέλου
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
Υποβολή μέσω REST
Χρησιμοποιήστε το προσωπικό σας κλειδί API (msk_…) για να δημιουργείτε εργασίες για αυτόν τον φόρτο εργασίας από τα δικά σας εργαλεία. Οι εργασίες που ξεκινούν με αυτόν τον τρόπο εκτελούνται στις ίδιες συσκευές που συνδέσατε στη σελίδα Οι συσκευές σας — τουλάχιστον μία πρέπει να είναι online.
https://cp.meshlabs.cloud/v1/organizations/jobsΈλεγχος ταυτότητας με X-Organization-Api-Key: msk_your_personal_api_key. Το όνομα της κεφαλίδας είναι ίδιο με των κλειδιών οργανισμού· τα προσωπικά κλειδιά χρησιμοποιούν το ίδιο τελικό σημείο.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign με το ίδιο κλειδί API, μεταφορτώστε το αρχείο σας στο upload_url που επιστρέφεται και μετά περάστε το download_url στο job_spec (για παράδειγμα ως input_image_url).Σώμα αιτήματος
{
"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"
}
}Πεδία του job_spec
| Πεδίο | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|
input_image_url | Ναι | — | Μια φωτογραφία ή απόδοση ενός μεμονωμένου αντικειμένου. Το θέμα αποκόπτεται αυτόματα, περικόπτεται σε τετράγωνο και αλλάζει μέγεθος σε 224x224, επομένως ένα μεμονωμένο σαφές θέμα δίνει την καλύτερη γεωμετρία — οι πολυάσχολες σκηνές και τα πολλά αντικείμενα μπερδεύουν την αποκοπή. Ένα PNG που έχει ήδη διαφάνεια παραλείπει το βήμα της αποκοπής και είναι η πιο αξιόπιστη είσοδος από όλες. |
remove_background | Όχι | true | Εκτελεί το μοντέλο τμηματοποίησης όταν η εικόνα δεν έχει δική της διαφάνεια. Απενεργοποιήστε το για εικόνα που είναι ήδη καθαρή αποκοπή σε λευκό ή όταν το θέμα γεμίζει το καρέ. |
steps | Όχι | 50 | Βήματα rectified-flow. Κάτω από περίπου 16 το σχήμα αναγνωρίζεται αλλά χάνει τις λεπτές ανάγλυφες λεπτομέρειες· πάνω από την προεπιλογή παύει να αλλάζει. |
guidance_scale | Όχι | 7 | Πόσο πιστά το mesh ακολουθεί την εικόνα αναφοράς. |
seed | Όχι | — | Τυχαίο seed για αναπαραγώγιμη δημιουργία. |
grid_resolution | Όχι | 192 | Ανάλυση του πεδίου από το οποίο εξάγεται η επιφάνεια. Το κόστος αυξάνεται με τον κύβο: το 256 είναι περίπου 2.4 φορές η εργασία της προεπιλογής, για διαφορά που ως επί το πλείστον δεν επιβιώνει της εξομάλυνσης. |
texture | Όχι | true | Προβάλλει τη φωτογραφία στο mesh ως υφή βασικού χρώματος. Η πλευρά που έδειχνε η φωτογραφία βγαίνει ευκρινής· η πίσω πλευρά είναι μια μουτζούρα του πλησιέστερου χρώματος περιγράμματος, επειδή μία εικόνα δεν μπορεί να τη δει. Απενεργοποιήστε το για απλό γκρι mesh — μικρότερο αρχείο και η σωστή επιλογή αν σκοπεύετε να του βάλετε μόνοι σας υφή. |
texture_upscale | Όχι | false | Εκτελεί πέρασμα υπερ-ανάλυσης 4x στο θέμα πριν από την προβολή του. Αξίζει μόνο όταν το θέμα είναι μικρό στο καρέ — η υφή δημιουργείται στη δική της ανάλυση της φωτογραφίας, επομένως μια μεγάλη σαφής φωτογραφία έχει ήδη περισσότερη λεπτομέρεια από όση χωράει και αυτό θα μεγέθυνε απλώς τη δική μας σμίκρυνση. Παραλείπεται αυτόματα όταν η φωτογραφία είναι αρκετά μεγάλη, επομένως αν το αφήσετε ενεργό δεν κοστίζει τίποτα εκτός από μια λήψη. |
texture_upscaler | Όχι | 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 με το ίδιο κλειδί API μέχρι το status να γίνει τελικό (COMPLETED, FAILED, CANCELED ή MODERATION_BLOCKED). Όταν η εποπτεία περιεχομένου είναι ενεργή, οι εργασίες μπορεί να ξεκινούν σε MODERATION_PENDING πριν μπουν στην ουρά υπολογισμού. Οι ολοκληρωμένες εργασίες περιλαμβάνουν προϋπογεγραμμένες τιμές download_url σε κάθε έξοδο.
Απόκριση δημιουργίας
{
"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"
}Απόκριση ολοκλήρωσης
{
"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>"
}Ανεβάστε μία φωτογραφία και κατεβάστε ένα τρισδιάστατο mesh (GLB). Το θέμα αποκόπτεται από το φόντο. Το χρώμα προέρχεται από τη φωτογραφία: η πλευρά που φωτογραφήσατε είναι ευκρινής, η πίσω πλευρά είναι πιο απαλή και δεν υπάρχουν χάρτες metallic ή roughness. Δωρεάν εικόνα σε 3D στις συσκευές που συνδέετε, μεταξύ άλλων σε κινητό. Την πρώτη φορά γίνεται λήψη του μοντέλου· οι επόμενες φωτογραφίες ξεκινούν πιο γρήγορα. Οι προχωρημένες επιλογές απενεργοποιούν την αποκοπή και την υφή και ενεργοποιούν μεγαλύτερη υφή όταν το θέμα είναι πολύ μικρό στο καρέ.