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

Tripo H3.1 Text to 3D

التكامل

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

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

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

مولّد شبكة ثلاثية الأبعاد من النص مع مطالبة سلبية ومستويين منفصلين لجودة الهندسة والنسيج وحد مرتفع جدًا لعدد الأوجه

Tripo · 3D

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

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

إنشاء طلب

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

•مطلوب 88 / 1024

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

texture_quality الافتراضي standard

إعداد جودة الأنسجة؛ يؤدي اختيار 'detailed' إلى زيادة دقة الأنسجة.

geometry_quality الافتراضي standard

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

متقدم negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

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

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

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

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

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

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

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

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

حول Tripo H3.1 Text to 3D

ينشئ نموذجًا ثلاثي الأبعاد من وصف نصي يصل إلى 1024 حرفًا، مع `negative_prompt` اختيارية للميزات المطلوب تجنبها. يقبل `face_limit` من 1,000 إلى 2,000,000 وجه. يمكن أن تكون `geometry_quality` و`texture_quality` قياسية أو تفصيلية. تشمل الخيارات مواد PBR وطوبولوجيا رباعية والقياس التلقائي إلى الحجم الواقعي وبذورًا منفصلة للهندسة وخطوة تحويل النص إلى صورة والنسيج.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 1,024 حرفًا
وصف نصي للكائن 3D المطلوب، بحد أقصى 1024 حرفًا.
negative_promptاختياري
النوعstring | null
≤ 1,024 حرفًا
وصف للميزات التي ينبغي استبعادها من النموذج المولّد.
face_limitاختياري
النوعinteger | null
1,000 – 2,000,000
هدف صريح لعدد أوجه الشبكة عند توليدها، ويتجاوز اختيار النموذج التكيفي للعدد عند تقديمه.
textureاختياري
النوعboolean
الافتراضيtrue
يتحكم فيما إذا كان النموذج يتلقى خامات مُولَّدة.
pbrاختياري
النوعboolean
الافتراضيtrue
تمكين مواد PBR (العرض المستند إلى الخصائص الفيزيائية)، ما يؤدي أيضًا إلى تمكين توليد الأنسجة عند ضبطه على true.
model_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الهندسة قابلاً للتكرار.
image_seedاختياري
النوعinteger | null
قيمة seed المستخدمة أثناء مرحلة تحويل النص إلى صورة.
texture_seedاختياري
النوعinteger | null
قيمة seed المستخدمة لجعل توليد الأنسجة قابلاً للتكرار.
texture_qualityاختياري
النوعenum
الافتراضيstandard
standarddetailed
إعداد جودة الأنسجة؛ يؤدي اختيار 'detailed' إلى زيادة دقة الأنسجة.
geometry_qualityاختياري
النوعenum
الافتراضيstandard
standarddetailed
إعداد جودة الهندسة.
auto_sizeاختياري
النوعboolean
الافتراضيfalse
تحجيم تلقائي لمنح النموذج أبعادًا واقعية مقاسة بالمتر.
quadاختياري
النوعboolean
الافتراضيfalse
الاختيار بين الأوجه المثلثة والرباعيات ذات 4 جوانب عبر تمكين طوبولوجيا الرباعيات. بالنسبة إلى النتائج الرباعية، يُعاد ملف FBX كلما زوّد Tripo البيانات على هيئة وحدات بايت FBX.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/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": 200,
    "usd": "0.20",
    "charged": 200,
    "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.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/text-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt