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

Tripo3D · Multiview to 3D

التكامل

معرّف النموذج tripo3d/tripo/v2.5/multiview-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/tripo/v2.5/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "front_image_url": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.30 $⁩ 300 رصيد API · ≈ ⁨‏32.19 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Tripo من صورة إلى 3D #stylized#multiview

تحويل متعدد الزوايا إلى نموذج ثلاثي الأبعاد (v2.5) باستخدام صورة أمامية مع زوايا يسرى وخلفية ويمنى اختيارية

Tripo · 3D

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

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

إنشاء طلب

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

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

صورة تعرض الكائن من الأمام.

texture الافتراضي standard

إعداد الأنسجة للنموذج: 'standard' هو الافتراضي، و'no' يعطّل الأنسجة، و'HD' ينتج أنسجة عالية الدقة.

إعداد النمط؛ اتركه غير محدد للحفاظ على المظهر والنمط الأصليين.

متقدم left_image_url · back_image_url · right_image_url · texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
أفلت ملفًا، أو

صورة تعرض الكائن من اليسار.

أفلت ملفًا، أو

صورة تعرض الكائن من الخلف.

أفلت ملفًا، أو

صورة تعرض الكائن من اليمين.

texture_alignment الافتراضي original_image

إعداد أولوية محاذاة الأنسجة لنموذج 3D، باستخدام original_image ما لم تُقدّم قيمة أخرى.

orientation الافتراضي default

اتجاه النموذج، مضبوط مبدئيًا على `default`. اختر `align_image` لتدوير النموذج تلقائيًا ومحاذاته مع الصورة الأصلية.

الحد الأقصى لعدد أوجه المخرج، ويُختار تكيفيًا ما لم تقدّم حدًا صريحًا.

قيمة seed صحيحة تتحكم في توليد الهندسة؛ تؤدي إعادة استخدامها إلى نماذج متطابقة. تُختار قيمة عشوائية عند حذفها.

قيمة seed لتوليد الأنسجة، تُقدّم كعدد صحيح أو تُختار عشوائيًا عند حذفها. تعيد قيم seed المتطابقة إنتاج الأنسجة نفسها؛ لتغيير أنسجة النموذج، غيّر texture_seed مع إبقاء seed النموذج ثابتًا.

POST /run/tripo3d/tripo/v2.5/multiview-to-3d?wait=20 عرض السعر → ⁨‏0.30 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/tripo/v2.5/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "front_image_url": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Tripo3D · Multiview to 3D

يبني نموذجًا ثلاثي الأبعاد من `front_image_url` المطلوبة و`left_image_url` و`back_image_url` و`right_image_url` الاختيارية، بحيث تحسن الزوايا الإضافية الهندسة. يمكن أن تكون الخامات بلا خامات أو قياسية أو HD، مع PBR اختياري. كما يوفر إعدادات نمط، و`face_limit`، وإخراجًا رباعيًا (يفرض FBX)، وضبطًا تلقائيًا للحجم، ومحاذاة للخامات، وتحكمًا في الاتجاه، إضافة إلى بذور منفصلة للهندسة والخامات.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
seedاختياري
النوعinteger | null
قيمة seed صحيحة تتحكم في توليد الهندسة؛ تؤدي إعادة استخدامها إلى نماذج متطابقة. تُختار قيمة عشوائية عند حذفها.
face_limitاختياري
النوعinteger | null
الحد الأقصى لعدد أوجه المخرج، ويُختار تكيفيًا ما لم تقدّم حدًا صريحًا.
pbrاختياري
النوعboolean | null
الافتراضيfalse
مفتاح PBR: تنتج False نموذجًا بلا PBR، بينما تتجاوز True إعداد الأنسجة وتتعامل معه على أنه True. يكون PBR مفعّلًا افتراضيًا.
textureاختياري
النوعenum
الافتراضيstandard
nostandardHD
إعداد الأنسجة للنموذج: 'standard' هو الافتراضي، و'no' يعطّل الأنسجة، و'HD' ينتج أنسجة عالية الدقة.
texture_seedاختياري
النوعinteger | null
قيمة seed لتوليد الأنسجة، تُقدّم كعدد صحيح أو تُختار عشوائيًا عند حذفها. تعيد قيم seed المتطابقة إنتاج الأنسجة نفسها؛ لتغيير أنسجة النموذج، غيّر texture_seed مع إبقاء seed النموذج ثابتًا.
auto_sizeاختياري
النوعboolean | null
الافتراضيfalse
مفتاح التحجيم الواقعي، معطّل افتراضيًا (False)، ويعدّل أبعاد النموذج تلقائيًا باستخدام المتر.
styleاختياري
النوعenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
إعداد النمط؛ اتركه غير محدد للحفاظ على المظهر والنمط الأصليين.
quadاختياري
النوعboolean | null
الافتراضيfalse
يفرض الوضع الرباعي إخراج FBX عند تمكينه. مع quad=True وعدم تحديد face_limit، تكون القيمة الافتراضية لـ face_limit هي 10000.
texture_alignmentاختياري
النوعenum
الافتراضيoriginal_image
original_imagegeometry
إعداد أولوية محاذاة الأنسجة لنموذج 3D، باستخدام original_image ما لم تُقدّم قيمة أخرى.
orientationاختياري
النوعenum
الافتراضيdefault
defaultalign_image
اتجاه النموذج، مضبوط مبدئيًا على `default`. اختر `align_image` لتدوير النموذج تلقائيًا ومحاذاته مع الصورة الأصلية.
front_image_urlمطلوب
النوعurl · image
صورة تعرض الكائن من الأمام.
left_image_urlاختياري
النوعurl · image
صورة تعرض الكائن من اليسار.
back_image_urlاختياري
النوعurl · image
صورة تعرض الكائن من الخلف.
right_image_urlاختياري
النوعurl · image
صورة تعرض الكائن من اليمين.
مطلوب

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/tripo/v2.5/multiview-to-3d",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "front_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "task_id": "string",
    "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
    },
    "base_model": {
      "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
    },
    "pbr_model": {
      "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
    },
    "rendered_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
    }
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
task_id
stringمعرّف المهمة الخاصة بتوليد نموذج 3D.
model_mesh
object {url, content_type, file_name, file_size} | nullمخرج النموذج.
base_model
object {url, content_type, file_name, file_size} | nullمخرج النموذج الأساسي.
pbr_model
object {url, content_type, file_name, file_size} | nullمخرج نموذج PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullصورة تعرض معاينة النموذج.

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

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