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

Tripo P2 Text to 3D

التكامل

معرّف النموذج tripo3d/p2/text-to-3d
# 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/p2/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

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

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

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

Tripo · 3D

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

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

إنشاء طلب

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

•مطلوب 88 / 1024

وصف نصي للكائن 3D المطلوب، بحد أقصى 1024 حرفًا.

texture_quality الافتراضي standard

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

متقدم negative_prompt · texture_version · export_orientation · face_limit · image_seed · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
0 / 255

وصف للميزات التي ينبغي استبعادها من النموذج المولّد.

texture_version

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

export_orientation

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

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

قيمة seed المستخدمة أثناء مرحلة تحويل النص إلى صورة الداخلية.

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

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

POST /run/tripo3d/p2/text-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.com/v1/run/tripo3d/p2/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

حول Tripo P2 Text to 3D

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

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 1,024 حرفًا
وصف نصي للكائن 3D المطلوب، بحد أقصى 1024 حرفًا.
negative_promptاختياري
النوعstring | null
≤ 255 حرفًا
وصف للميزات التي ينبغي استبعادها من النموذج المولّد.
image_seedاختياري
النوعinteger | null
قيمة seed المستخدمة أثناء مرحلة تحويل النص إلى صورة الداخلية.
model_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الهندسة قابلاً للتكرار.
face_limitاختياري
النوعinteger | null
48 – 50,000
الحد الأعلى لعدد أوجه الشبكة، مع حد منفصل قدره 25,000 لطوبولوجيا الرباعيات.
textureاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان النموذج يتلقى خامات مُولَّدة.
pbrاختياري
النوعboolean
الافتراضيtrue
يتحكم في توليد خرائط مواد PBR. يؤدي تمكين PBR أيضًا إلى تفعيل الأنسجة.
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، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/p2/text-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": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.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}ملف 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/text-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt