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

Tripo H3.1 Multiview to 3D

التكامل

معرّف النموذج tripo3d/h3.1/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/h3.1/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
      "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.27 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Tripo من صورة إلى 3D #3d#multiview-to-3d#3d-generation#tripo

ينشئ نموذجًا ثلاثي الأبعاد من 2 إلى 4 مناظير لعنصر واحد، مرتبة أمامًا ويسارًا وخلفًا ويمينًا

Tripo · 3D

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

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

إنشاء طلب

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

•مطلوب image_urls
أفلت ملفًا، أو · حتى 4

عناوين URL لصور متعددة الزوايا لكائن واحد، تتضمن منظرًا أماميًا إلزاميًا. قدّم من 2 إلى 4 عناوين URL بالترتيب [front, left, back, right].

texture_quality الافتراضي standard

إعداد جودة الأنسجة.

geometry_quality الافتراضي standard

إعداد جودة الهندسة.

متقدم texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment الافتراضي original_image

طريقة محاذاة الأنسجة.

orientation الافتراضي default

اتجاه النموذج.

هدف صريح لعدد أوجه الشبكة عند توليدها، ويتجاوز اختيار النموذج التكيفي للعدد عند تقديمه.

قيمة seed المستخدمة لجعل توليد الهندسة قابلاً للتكرار.

قيمة seed المستخدمة لجعل توليد الأنسجة قابلاً للتكرار.

POST /run/tripo3d/h3.1/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/h3.1/multiview-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
      "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

حول Tripo H3.1 Multiview to 3D

يستقبل من 2 إلى 4 صور للعنصر نفسه في `image_urls`، مرتبة أمامًا ويسارًا وخلفًا ويمينًا، مع اشتراط المنظور الأمامي. يشترك في خيارات الصورة الواحدة: `face_limit` (من 1,000 إلى 2,000,000) و`pbr` وجودة النسيج والهندسة وشبكات `quad` و`auto_size`. يعيد النموذج وعرضًا تمهيديًا ومعرّف مهمة.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlsمطلوب images
النوعurl[] · image
≤ 4 عناصر≥ 2 عنصرين
عناوين URL لصور متعددة الزوايا لكائن واحد، تتضمن منظرًا أماميًا إلزاميًا. قدّم من 2 إلى 4 عناوين URL بالترتيب [front, left, back, right].
face_limitاختياري
النوعinteger | null
1,000 – 2,000,000
هدف صريح لعدد أوجه الشبكة عند توليدها، ويتجاوز اختيار النموذج التكيفي للعدد عند تقديمه.
textureاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان النموذج يتلقى خامات مُولَّدة.
pbrاختياري
النوعboolean
الافتراضيtrue
تمكين مواد PBR (العرض المستند إلى الخصائص الفيزيائية)، ما يؤدي أيضًا إلى تمكين توليد الأنسجة عند ضبطه على true.
model_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الهندسة قابلاً للتكرار.
texture_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الأنسجة قابلاً للتكرار.
texture_qualityاختياري
النوعenum
الافتراضيstandard
standarddetailed
إعداد جودة الأنسجة.
geometry_qualityاختياري
النوعenum
الافتراضيstandard
standarddetailed
إعداد جودة الهندسة.
texture_alignmentاختياري
النوعenum
الافتراضيoriginal_image
original_imagegeometry
طريقة محاذاة الأنسجة.
auto_sizeاختياري
النوعboolean
الافتراضيfalse
تحجيم تلقائي لمنح النموذج أبعادًا واقعية مقاسة بالمتر.
orientationاختياري
النوعenum
الافتراضيdefault
defaultalign_image
اتجاه النموذج.
quadاختياري
النوعboolean
الافتراضيfalse
الاختيار بين الأوجه المثلثة والرباعيات ذات 4 جوانب عبر تمكين طوبولوجيا الرباعيات. بالنسبة إلى النتائج الرباعية، يُعاد ملف FBX كلما زوّد Tripo البيانات على هيئة وحدات بايت FBX.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/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": {
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
      "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
    },
    "model_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
    },
    "task_id": "string"
  },
  "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
model_mesh
object {url, content_type, file_name, file_size}ملف GLB أو FBX يحتوي على نموذج 3D المولّد، ويحدد التنسيق ما ينتجه Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}عناوين URL تشير إلى إصدارات بديلة من نموذج 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullمعاينة مُصيّرة تعرض نموذج 3D المولّد.
task_id
string | nullمعرّف مهمة Tripo قابل لإعادة الاستخدام يعرّف النموذج المولّد لعمليات rig أو rig-check، ما يتيح تنفيذ تلك العمليات دون رفع نموذج آخر.

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

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