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

Trellis

التكامل

معرّف النموذج trellis
# 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/trellis?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.02 $⁩ 20 رصيد API · ≈ ⁨‏2.11 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Microsoft من صورة إلى 3D #stylized

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

Microsoft · 3D

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

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

إنشاء طلب

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

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

عنوان URL يشير إلى الصورة المصدر للتحويل إلى 3D.

متقدم texture_size · ss_guidance_strength · ss_sampling_steps · slat_guidance_strength · slat_sampling_steps · mesh_simplify · seed
texture_size الافتراضي 1024

الدقة المستخدمة للخامة.

الافتراضي 7.5

شدة الإرشاد المستخدمة عند توليد البنية المتناثرة.

الافتراضي 12

عدد خطوات أخذ العينات المستخدمة لتوليد البنية المتناثرة.

الافتراضي 3

شدة الإرشاد المستخدمة عند توليد الكامنات المنظمة.

الافتراضي 12

عدد خطوات أخذ العينات المستخدمة لتوليد الكامنات المنظمة.

الافتراضي 0.95

العامل المتحكم في تبسيط الشبكة.

البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.

POST /run/trellis?wait=20 عرض السعر → ⁨‏0.02 $⁩
# 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/trellis?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

حول Trellis

يحوّل صورة واحدة من `image_url` إلى شبكة ثلاثية الأبعاد ذات نسيج. تشمل المعاملات القابلة للضبط قوة التوجيه وخطوات أخذ العينات لمراحل البنية والمجال الكامن، و`mesh_simplify` (من 0.9 إلى 0.98)، و`texture_size` بقيمة 512 أو 1024 أو 2048. يجعل `seed` النتائج قابلة للتكرار.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL يشير إلى الصورة المصدر للتحويل إلى 3D.
seedاختياري
النوعinteger | null
البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.
ss_guidance_strengthاختياري
النوعnumber
الافتراضي7.5
0 – 10
شدة الإرشاد المستخدمة عند توليد البنية المتناثرة.
ss_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات أخذ العينات المستخدمة لتوليد البنية المتناثرة.
slat_guidance_strengthاختياري
النوعnumber
الافتراضي3
0 – 10
شدة الإرشاد المستخدمة عند توليد الكامنات المنظمة.
slat_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات أخذ العينات المستخدمة لتوليد الكامنات المنظمة.
mesh_simplifyاختياري
النوعnumber
الافتراضي0.95
0.9 – 0.98
العامل المتحكم في تبسيط الشبكة.
texture_sizeاختياري
النوعenum
الافتراضي1024
51210242048
الدقة المستخدمة للخامة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "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
    },
    "timings": {}
  },
  "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}ملف يحتوي على الشبكة ثلاثية الأبعاد المُولَّدة.
timings
objectقياسات التوقيت الخاصة بالمعالجة.

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

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