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

Tripo P2 Image to 3D

التكامل

معرّف النموذج tripo3d/p2/image-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/p2/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏1.10 $⁩ 1,100 رصيد API · ≈ ⁨‏118.34 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

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

تحويل صورة إلى ثلاثية أبعاد مع PBR وطوبولوجيا رباعية وأربعة مستويات لجودة النسيج واختيار إصدار النسيج

Tripo · 3D

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

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

إنشاء طلب

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

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

عنوان URL لصورة المدخل المستخدمة لإنشاء نموذج ثلاثي الأبعاد.

texture_quality الافتراضي standard

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

متقدم texture_version · export_orientation · face_limit · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
texture_version

الإصدار المستخدم لنمذجة الأنسجة. للحصول على جودة سريعة، اختر v3.5-20260815؛ الإصدارات الأخرى غير مدعومة لهذه الجودة.

export_orientation

إعداد المحور الأمامي لتصدير النموذج، عند تحديده.

الحد الأعلى لعدد أوجه الشبكة، مع حد منفصل قدره 25,000 لطوبولوجيا الرباعيات.

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

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

POST /run/tripo3d/p2/image-to-3d?wait=20 عرض السعر → ⁨‏1.10 $⁩
# 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/p2/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Tripo P2 Image to 3D

يحوّل صورة واحدة من `image_url` إلى نموذج ثلاثي الأبعاد يصل إلى 50,000 وجه (25,000 للشبكات الرباعية). يمكن أن تكون جودة النسيج سريعة أو قياسية أو تفصيلية أو قصوى، ويحدد `texture_version` نموذج النسيج. تشمل الخيارات الأخرى خرائط PBR والإضاءة التجميلية وتصدير UV والتحجيم التلقائي ومحور التصدير الأمامي (`export_orientation`). تتحكم بذور منفصلة في الهندسة والأنسجة.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة المدخل المستخدمة لإنشاء نموذج ثلاثي الأبعاد.
face_limitاختياري
النوعinteger | null
48 – 50,000
الحد الأعلى لعدد أوجه الشبكة، مع حد منفصل قدره 25,000 لطوبولوجيا الرباعيات.
textureاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان النموذج يتلقى خامات مُولَّدة.
pbrاختياري
النوعboolean
الافتراضيtrue
يتحكم في توليد خرائط مواد PBR. يؤدي تمكين PBR أيضًا إلى تفعيل الأنسجة.
model_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الهندسة قابلاً للتكرار.
texture_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الأنسجة قابلاً للتكرار.
texture_qualityاختياري
النوعenum
الافتراضيstandard
faststandarddetailedextreme
إعداد جودة الأنسجة.
texture_versionاختياري
النوعenum
v3.5-20260815v3.0-20250812v2.5-20250123
الإصدار المستخدم لنمذجة الأنسجة. للحصول على جودة سريعة، اختر v3.5-20260815؛ الإصدارات الأخرى غير مدعومة لهذه الجودة.
delightاختياري
النوعboolean
الافتراضيtrue
إزالة الإضاءة المخبوزة مسبقًا قبل تطبيق الأنسجة باستخدام v3.5-20260815.
auto_sizeاختياري
النوعboolean
الافتراضيfalse
تحجيم تلقائي لمنح النموذج أبعادًا واقعية مقاسة بالمتر.
export_uvاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان النموذج سيتلقى إحداثيات UV مولّدة.
export_orientationاختياري
النوعenum
+x-x-y+y
إعداد المحور الأمامي لتصدير النموذج، عند تحديده.
quadاختياري
النوعboolean
الافتراضيfalse
طوبولوجيا الشبكة باستخدام الرباعيات بدلًا من المثلثات.
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/p2/image-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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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
    },
    "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/p2/image-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt