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

Trellis 2 · Retexture

التكامل

معرّف النموذج trellis-2/retexture
# 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/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

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

هذا الطلب: ⁨‏0.24 $⁩ 240 رصيد API تشغيله في هذه الصفحة

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

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

Microsoft · 3D

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

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

إنشاء طلب

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

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

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

resolution الافتراضي 1024

تعتمد تفاصيل الخامة وسرعة المعالجة على دقة التوليد الداخلية هذه: تؤدي زيادتها إلى تفاصيل أدق لكنها تستغرق وقتًا أطول.

•مطلوب

عنوان URL لمصدر إعادة إضافة الخامة إلى شبكة ثلاثية الأبعاد دون خامة، بتنسيق GLB أو OBJ أو PLY أو STL.

متقدم texture_size · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · seed
texture_size الافتراضي 2048

دقة نسيج الشبكة للخبز. تؤدي زيادة هذه الدقة إلى تفاصيل سطحية أدق وملفات أكبر.

الافتراضي 1

التحكم في دقة ألوان النسيج: يؤدي الالتزام الأقرب بألوان الصورة المدخلة عند الإعدادات الأعلى إلى زيادة الحيوية، لكنه قد يسبب فرط التشبع.

الافتراضي 0

زد هذا الإعداد لمعالجة الأنسجة المشوشة أو تدرج الألوان؛ فهو يقلل التشوهات الناتجة عن التوجيه القوي أثناء مرحلة النسيج.

الافتراضي 0.6

نقطة تفعيل الإرشاد الخالي من المصنّف لتوليد الخامة. معبرًا عنها بكسر من تقدم إزالة التشويش، فإنها تضبط interval_start؛ ويعمل الإرشاد ضمن النافذة المحصورة بين interval_start وinterval_end فقط.

الافتراضي 0.9

حد التوقف لإرشاد المرحلة الخاصة بالخامة الخالي من المصنّف، محددًا بكسر إزالة تشويش لا يقل عن tex_slat_guidance_interval_start.

الافتراضي 12

عدد خطوات إزالة التشويش المستخدمة لتوليد الأنسجة. تؤدي زيادة العدد إلى وقت أطول، لكنها قد تنتج أنسجة أنظف.

الافتراضي 3

حدد حدة تفاصيل النسيج عبر جدول ضوضاء توليد النسيج؛ تؤدي زيادة هذه القيمة إلى تفاصيل أكثر حدة.

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

POST /run/trellis-2/retexture?wait=20 عرض السعر → ⁨‏0.24 $⁩
# 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/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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

حول Trellis 2 · Retexture

يطبّق نسيجًا جديدًا على الشبكة الموجودة في `mesh_url` (بصيغ GLB أو OBJ أو PLY أو STL) استنادًا إلى `image_url` مرجعية. تكون `resolution` بقيمة 512 أو 1024، و`texture_size` بقيمة 1024 أو 2048 أو 4096. تتوفر إعدادات التوجيه وأخذ العينات لمرحلة النسيج. لا تتم إعادة توليد الهندسة.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المرجعية المستخدم لإضافة الخامة.
mesh_urlمطلوب
النوعstring
عنوان URL لمصدر إعادة إضافة الخامة إلى شبكة ثلاثية الأبعاد دون خامة، بتنسيق GLB أو OBJ أو PLY أو STL.
seedاختياري
النوعinteger | null
البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.
resolutionاختياري
النوعenum
الافتراضي1024
5121024
تعتمد تفاصيل الخامة وسرعة المعالجة على دقة التوليد الداخلية هذه: تؤدي زيادتها إلى تفاصيل أدق لكنها تستغرق وقتًا أطول.
tex_slat_guidance_strengthاختياري
النوعnumber
الافتراضي1
0 – 10
التحكم في دقة ألوان النسيج: يؤدي الالتزام الأقرب بألوان الصورة المدخلة عند الإعدادات الأعلى إلى زيادة الحيوية، لكنه قد يسبب فرط التشبع.
tex_slat_guidance_rescaleاختياري
النوعnumber
الافتراضي0
0 – 1
زد هذا الإعداد لمعالجة الأنسجة المشوشة أو تدرج الألوان؛ فهو يقلل التشوهات الناتجة عن التوجيه القوي أثناء مرحلة النسيج.
tex_slat_guidance_interval_startاختياري
النوعnumber
الافتراضي0.6
0 – 1
نقطة تفعيل الإرشاد الخالي من المصنّف لتوليد الخامة. معبرًا عنها بكسر من تقدم إزالة التشويش، فإنها تضبط interval_start؛ ويعمل الإرشاد ضمن النافذة المحصورة بين interval_start وinterval_end فقط.
tex_slat_guidance_interval_endاختياري
النوعnumber
الافتراضي0.9
0 – 1
حد التوقف لإرشاد المرحلة الخاصة بالخامة الخالي من المصنّف، محددًا بكسر إزالة تشويش لا يقل عن tex_slat_guidance_interval_start.
tex_slat_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات إزالة التشويش المستخدمة لتوليد الأنسجة. تؤدي زيادة العدد إلى وقت أطول، لكنها قد تنتج أنسجة أنظف.
tex_slat_rescale_tاختياري
النوعnumber
الافتراضي3
1 – 6
حدد حدة تفاصيل النسيج عبر جدول ضوضاء توليد النسيج؛ تؤدي زيادة هذه القيمة إلى تفاصيل أكثر حدة.
texture_sizeاختياري
النوعenum
الافتراضي2048
102420484096
دقة نسيج الشبكة للخبز. تؤدي زيادة هذه الدقة إلى تفاصيل سطحية أدق وملفات أكبر.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "model_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
    }
  },
  "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_glb
object {url, content_type, file_name, file_size}نموذج 3D مُولّد بتنسيق GLB.

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

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