3D
TripoSG – obrázek na 3D
Proměňte jednu fotografii v 3D síť ke stažení, i na telefonu.
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.
Licence 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.
Reference API
Odeslání přes REST
Pomocí svého osobního klíče API (msk_…) vytvářejte úlohy pro tuto úlohu ze svých vlastních nástrojů. Takto spuštěné úlohy běží na stejných zařízeních, která jste připojili na stránce Vaše zařízení — alespoň jedno z nich musí být online.
https://cp.meshlabs.cloud/v1/organizations/jobsOvěřujte se pomocí X-Organization-Api-Key: msk_your_personal_api_key. Název hlavičky odpovídá klíčům organizace; osobní klíče používají stejný koncový bod.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign se stejným klíčem API, nahrajte soubor na vrácenou adresu upload_url a poté předejte download_url v job_spec (například jako input_image_url).Tělo požadavku
{
"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"
}
}Pole job_spec
| Pole | Povinné | Výchozí | Popis |
|---|---|---|---|
input_image_url | Ano | — | Fotografie nebo render jednoho objektu. Objekt se automaticky vyřízne, ořízne do čtverce a změní na 224x224, takže nejlepší geometrii dává jeden jasný objekt – rušné scény a více objektů výřez matou. PNG, které už má průhlednost, krok výřezu přeskočí a je ze všech vstupů nejspolehlivější. |
remove_background | Ne | true | Spustí segmentační model, pokud obrázek nemá vlastní průhlednost. Vypněte u obrázku, který už je čistým výřezem na bílé, nebo když objekt vyplňuje celý záběr. |
steps | Ne | 50 | Kroky rectified-flow. Pod zhruba 16 je tvar rozpoznatelný, ale ztrácí jemný reliéf; nad výchozí hodnotou se už nemění. |
guidance_scale | Ne | 7 | Jak přesně síť sleduje referenční obrázek. |
seed | Ne | — | Náhodný seed pro reprodukovatelné generování. |
grid_resolution | Ne | 192 | Rozlišení pole, ze kterého se povrch extrahuje. Náklady rostou s třetí mocninou: 256 je zhruba 2,4násobek práce oproti výchozí hodnotě, za rozdíl, který po vyhlazení většinou nepřežije. |
texture | Ne | true | Promítne fotografii na síť jako texturu základní barvy. Strana zobrazená na fotografii vyjde ostrá; vzdálená strana je rozmazání nejbližší barvy siluety, protože ji jeden obrázek nevidí. Vypněte pro hladkou šedou síť – menší soubor a správná volba, pokud ji budete texturovat sami. |
texture_upscale | Ne | false | Před promítnutím spustí nad objektem průchod super-rozlišení 4x. Má smysl, jen když je objekt v záběru malý – textura se vytváří v rozlišení samotné fotografie, takže velká jasná fotografie už obsahuje víc detailu, než unese, a toto by jen zvětšilo naše vlastní zmenšení. Pokud je fotografie dostatečně velká, automaticky se přeskočí, takže ponechání zapnuté stojí jen stažení. |
texture_upscaler | Ne | 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}Dotazujte se se stejným klíčem API, dokud status nedosáhne koncového stavu (COMPLETED, FAILED, CANCELED nebo MODERATION_BLOCKED). Když je zapnuto moderování obsahu, mohou úlohy začínat ve stavu MODERATION_PENDING, než vstoupí do výpočetní fronty. Dokončené úlohy obsahují u každého výstupu předem podepsané hodnoty download_url.
Odpověď na vytvoření
{
"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"
}Odpověď po dokončení
{
"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>"
}Nahrajte jednu fotografii a stáhněte si 3D síť (GLB). Objekt se vyřízne z pozadí. Barva pochází z fotografie: strana, kterou jste vyfotili, je ostrá, vzdálená strana je měkčí a nejsou k dispozici mapy kovovosti ani drsnosti. Obrázek na 3D zdarma na zařízeních, která připojíte, včetně telefonu. První spuštění stáhne model; další fotografie začnou rychleji. Pokročilé volby umožňují vypnout výřez i texturu a zapnout větší texturu, pokud je objekt v záběru příliš malý.