3D
TripoSG — obraz na 3D
Zamień jedno zdjęcie w siatkę 3D do pobrania, także na telefonie.
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.
Licencje modelu
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.
Dokumentacja API
Przesyłaj przez REST
Użyj swojego osobistego klucza API (msk_…), aby tworzyć zadania dla tego obciążenia z własnych narzędzi. Zadania uruchamiane w ten sposób działają na tych samych urządzeniach, które podłączyłeś(-aś) w sekcji Twoje urządzenia — co najmniej jedno musi być online.
https://cp.meshlabs.cloud/v1/organizations/jobsUwierzytelnij się za pomocą X-Organization-Api-Key: msk_your_personal_api_key. Nazwa nagłówka jest taka sama jak dla kluczy organizacji; klucze osobiste używają tego samego punktu końcowego.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign z tym samym kluczem API, prześlij plik pod zwrócony upload_url, a następnie przekaż download_url w job_spec (na przykład jako input_image_url).Treść żądania
{
"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"
}
}Pola: job_spec
| Pole | Wymagane | Domyślnie | Opis |
|---|---|---|---|
input_image_url | Tak | — | Zdjęcie lub render pojedynczego obiektu. Obiekt jest wycinany automatycznie, przycinany do kwadratu i skalowany do 224x224, więc pojedynczy, wyraźny obiekt daje najlepszą geometrię — zatłoczone sceny i wiele obiektów mylą wycinanie. PNG, który ma już przezroczystość, pomija krok wycinania i jest najpewniejszym wejściem ze wszystkich. |
remove_background | Nie | true | Uruchom model segmentacji, gdy obraz nie ma własnej przezroczystości. Wyłącz dla obrazu, który jest już czystym wycięciem na białym tle, albo gdy obiekt wypełnia kadr. |
steps | Nie | 50 | Kroki rectified-flow. Poniżej około 16 kształt jest rozpoznawalny, ale traci drobny relief; powyżej wartości domyślnej przestaje się zmieniać. |
guidance_scale | Nie | 7 | Jak ściśle siatka podąża za obrazem referencyjnym. |
seed | Nie | — | Ziarno losowości dla powtarzalnego generowania. |
grid_resolution | Nie | 192 | Rozdzielczość pola, z którego wydobywana jest powierzchnia. Koszt rośnie z sześcianem: 256 to mniej więcej 2,4 raza więcej pracy niż wartość domyślna, za różnicę, która w większości nie przetrwa wygładzania. |
texture | Nie | true | Rzutuje zdjęcie na siatkę jako teksturę koloru bazowego. Strona widoczna na zdjęciu wychodzi ostra; odległa strona to rozmycie koloru najbliższej sylwetki, bo jeden obraz jej nie widzi. Wyłącz, aby uzyskać gładką szarą siatkę — mniejszy plik i dobry wybór, jeśli zamierzasz sam ją teksturować. |
texture_upscale | Nie | false | Uruchom 4-krotne super-rozdzielanie obiektu przed jego rzutowaniem. Warto tylko wtedy, gdy obiekt jest mały w kadrze — tekstura jest budowana w rozdzielczości samego zdjęcia, więc duże, wyraźne zdjęcie ma już więcej szczegółów, niż mieści, a to tylko powiększyłoby nasze własne pomniejszenie. Jest automatycznie pomijane, gdy zdjęcie jest wystarczająco duże, więc pozostawienie włączonego kosztuje tylko pobranie. |
texture_upscaler | Nie | 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}Odpytuj z tym samym kluczem API, aż status osiągnie stan końcowy (COMPLETED, FAILED, CANCELED lub MODERATION_BLOCKED). Gdy włączona jest moderacja treści, zadania mogą zaczynać się w stanie MODERATION_PENDING, zanim trafią do kolejki obliczeń. Ukończone zadania zawierają wstępnie podpisane wartości download_url przy każdym wyniku.
Odpowiedź na utworzenie
{
"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"
}Odpowiedź po ukończeniu
{
"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>"
}Prześlij jedno zdjęcie i pobierz siatkę 3D (GLB). Obiekt jest wycinany z tła. Kolor pochodzi ze zdjęcia: strona, którą sfotografowałeś, jest ostra, odległa strona jest bardziej miękka, a map metaliczności i chropowatości nie ma. Darmowa zamiana obrazu na 3D na podłączonych urządzeniach, także na telefonie. Pierwsze uruchomienie pobiera model; kolejne zdjęcia startują szybciej. Opcje zaawansowane pozwalają wyłączyć wycinanie i teksturę oraz włączyć większą teksturę, gdy obiekt jest zbyt mały w kadrze.