3D

TripoSG من صورة إلى 3D

حوّل صورة واحدة إلى شبكة ثلاثية الأبعاد يمكنك تنزيلها، بما في ذلك على الهاتف.

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.

الترخيص المرفق

إشعار

مجانيعبر الإنترنتبلا حدودUltraSharp الوصول عبر API

مرجع API

الإرسال عبر REST

استخدم مفتاح API الشخصي (msk_…) لإنشاء مهام لحمل العمل هذا من أدواتك. تعمل المهام التي تبدأ بهذه الطريقة على الأجهزة نفسها التي ربطتها في أجهزتك — يجب أن يكون أحدها على الأقل متصلًا.

إخفاء تفاصيل API
POSThttps://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خطوات التدفق المصحَّح. دون نحو 16 يبقى الشكل معروفًا لكنه يفقد التضاريس الدقيقة؛ وفوق القيمة الافتراضية يتوقف عن التغيّر.
guidance_scaleلا7مدى التزام الشبكة بالصورة المرجعية.
seedلا—بذرة عشوائية لتوليد قابل لإعادة الإنتاج.
grid_resolutionلا192دقة الحقل الذي يُستخرج منه السطح. تتزايد الكلفة بالمكعب: القيمة 256 تعادل نحو 2.4 ضعف عمل القيمة الافتراضية، مقابل فرق لا يبقى معظمه بعد التنعيم.
textureلاtrueأسقط الصورة على الشبكة كنسيج للون الأساسي. يخرج الجانب الذي أظهرته الصورة واضحًا؛ أما الجانب البعيد فتلطيخ بأقرب لون من الحدود الخارجية، لأن صورة واحدة لا تراه. أوقفه للحصول على شبكة رمادية سادة، بملف أصغر، وهو الخيار الصحيح إن كنت ستنسّجها بنفسك.
texture_upscaleلاfalseشغّل تمريرة دقة فائقة 4x على الموضوع قبل إسقاطه. لا يستحق ذلك إلا عندما يكون الموضوع صغيرًا في الإطار؛ فالنسيج يُبنى بدقة الصورة نفسها، لذا فالصورة الكبيرة الواضحة تحتوي بالفعل على تفاصيل أكثر مما يحمله، وهذا لن يفعل سوى تكبير تصغيرنا نحن. يُتخطى تلقائيًا عندما تكون الصورة كبيرة بما يكفي، فإبقاؤه مفعَّلًا لا يكلّف سوى تنزيل.
texture_upscalerلاultrasharpUltraSharp: 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"
  }
}'
GEThttps://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}

استطلع بمفتاح 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>"
}

ارفع صورة واحدة ونزّل شبكة ثلاثية الأبعاد (GLB). يُقتطع الموضوع من الخلفية. تأتي الألوان من الصورة: الجانب الذي صوّرته واضح، والجانب البعيد أنعم، ولا توجد خرائط للمعدنية أو الخشونة. تحويل الصورة إلى 3D مجانًا على الأجهزة التي تربطها، بما فيها الهاتف. يُنزَّل النموذج في التشغيل الأول، وتبدأ الصور اللاحقة أسرع. تتيح الخيارات المتقدمة إيقاف الاقتطاع والنسيج، وتفعيل نسيج أكبر عندما يكون الموضوع صغيرًا جدًا في الإطار.