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

Tripo3D · Image to 3D

التكامل

معرّف النموذج tripo3d/tripo/v2.5/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/tripo/v2.5/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"

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

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

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

Tripo · 3D

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

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

إنشاء طلب

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

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

عنوان URL للصورة المستخدمة لتوليد النموذج.

texture الافتراضي standard

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

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

متقدم 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/image-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/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

حول Tripo3D · Image to 3D

ينشئ نموذجًا ثلاثي الأبعاد من `image_url` واحدة. يمكن أن تكون `texture` بلا خامات أو قياسية أو HD، مع إخراج PBR اختياري. ويمكن لإعداد `style` مثل clay أو steampunk أو gold أو ancient bronze تغيير نمط النتيجة. تشمل عناصر التحكم الأخرى `face_limit` و`quad` (يفرض FBX) و`auto_size` و`texture_alignment` و`orientation` لمحاذاة النموذج مع الصورة.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
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` لتدوير النموذج تلقائيًا ومحاذاته مع الصورة الأصلية.
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المستخدمة لتوليد النموذج.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/tripo/v2.5/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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "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/image-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt