تخطّي إلى المحتوى

Triposplat

التكامل

معرّف النموذج tripo3d/triposplat
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/triposplat?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.05 $⁩ 50 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Tripo من صورة إلى 3D #3d#gaussian-splat

يحوّل صورة واحدة إلى ملف Gaussian splat ثلاثي الأبعاد، ويصدره بصيغة .ply أو .splat

Tripo · 3D

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL للصورة المصدر لتحويلها إلى Gaussian splat ثلاثي الأبعاد.

متقدم output_format · num_gaussians · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format الافتراضي ply

تنسيق ملف المخرج لـ Gaussian splat.

الافتراضي 262144

عدد Gaussian المطلوب للـ splat المولّد، ويُقرّب داخليًا إلى أقرب مضاعف لـ 32. تؤدي زيادته إلى إضافة تفاصيل، لكنها تزيد أيضًا حجم الملف وتبطئ التصيير.

الافتراضي 20

عدد الخطوات لأخذ عينات مطابقة التدفق.

الافتراضي 3

يتحكم في التوجيه الخالي من المصنّف، حيث تضيف الإعدادات الأقوى تفاصيل وتقرب النتيجة من الصورة المصدر مع احتمال تشبع الألوان بدرجة زائدة. يتوقف التوجيه عند 1.0 أو أقل.

قيمة seed المستخدمة لإعادة إنتاج النتائج. يؤدي ضبطها على None إلى اختيار seed عشوائي.

POST /run/tripo3d/triposplat?wait=20 عرض السعر → ⁨‏0.05 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/triposplat?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Triposplat

ينشئ Gaussian splat ثلاثي الأبعاد من صورة واحدة (`image_url`) بدلًا من شبكة. يتراوح `num_gaussians` بين 32,768 و262,144، وتكون `output_format` بصيغة ply أو splat. ويمكن أيضًا ضبط `num_inference_steps` (1-50) و`guidance_scale` و`seed`. تتضمن الاستجابة العدد الفعلي لـ Gaussian والصورة التي أزيلت خلفيتها واستخدمها النموذج.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المصدر لتحويلها إلى Gaussian splat ثلاثي الأبعاد.
num_gaussiansاختياري
النوعinteger
الافتراضي262144
32,768 – 262,144
عدد Gaussian المطلوب للـ splat المولّد، ويُقرّب داخليًا إلى أقرب مضاعف لـ 32. تؤدي زيادته إلى إضافة تفاصيل، لكنها تزيد أيضًا حجم الملف وتبطئ التصيير.
num_inference_stepsاختياري
النوعinteger
الافتراضي20
1 – 50
عدد الخطوات لأخذ عينات مطابقة التدفق.
guidance_scaleاختياري
النوعnumber
الافتراضي3
0 – 10
يتحكم في التوجيه الخالي من المصنّف، حيث تضيف الإعدادات الأقوى تفاصيل وتقرب النتيجة من الصورة المصدر مع احتمال تشبع الألوان بدرجة زائدة. يتوقف التوجيه عند 1.0 أو أقل.
output_formatاختياري
النوعenum
الافتراضيply
plysplat
تنسيق ملف المخرج لـ Gaussian splat.
seedاختياري
النوعinteger | null
قيمة seed المستخدمة لإعادة إنتاج النتائج. يؤدي ضبطها على None إلى اختيار seed عشوائي.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص سلامة الصورة المصدر.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/triposplat",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "preprocessed_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "num_gaussians": 1,
    "seed": 42,
    "timings": {}
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
model_mesh
object {url, content_type, file_name, file_size}ملف مخرج يحتوي على Gaussian splat ثلاثي الأبعاد، بصيغة .ply أو .splat.
preprocessed_image
object {url, content_type, file_name, file_size, width, height}الصورة المستخدمة فعليًا من النموذج: تركيب RGB يعرض المقدمة على خلفية سوداء بعد إزالة الخلفية.
num_gaussians
integerالعدد الفعلي لـ Gaussian المولّدة.
seed
integerقيمة البذرة المطبّقة أثناء التوليد.
timings
objectالوقت المستغرق في كل مرحلة، مقاسًا بالثواني.

مزيد من النماذج: من صورة إلى 3D

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/tripo3d/triposplat.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt