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

TRELLIS.2 LoRA Inference

التكامل

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

الحصول على مفتاح API

تحويل صورة إلى ثلاثية أبعاد باستخدام Trellis 2، مع إمكانية تطبيق محولات LoRA مخصصة للبنية والهندسة والنسيج

Microsoft · 3D

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

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

إنشاء طلب

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

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

عنوان URL لصورة المصدر لتحويلها إلى نموذج ثلاثي الأبعاد.

resolution الافتراضي 512

دقة التوليد، حيث يختار 1024 خط أنابيب التتابع. اختر الدقة المستخدمة لتدريب محولات LoRA المقدمة؛ ويجب التطابق.

متقدم texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · 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 · decimation_target · seed · enable_safety_checker

نقطة فحص LoRA اختيارية بتنسيق safetensors، مدرَّبة خصيصًا لمزيل تشويش الخامة.

texture_size الافتراضي 2048

دقة الخامات المخبوزة في تصدير GLB.

نقطة فحص LoRA اختيارية بتنسيق safetensors، مدرَّبة خصيصًا لمزيل تشويش البنية المتناثرة.

نقطة فحص LoRA اختيارية بتنسيق safetensors، مدرَّبة خصيصًا لمزيل تشويش الهندسة.

الافتراضي 7.5

قوة الإرشاد الخالي من المصنّف أثناء توليد البنية المتناثرة.

الافتراضي 0.7

إعادة تحجيم الإرشاد أثناء توليد البنية المتناثرة. تجعل القيم الأكبر المخرج أكثر استقرارًا.

الافتراضي 0.6

كسر تقدم إزالة التشويش الذي يبدأ عنده إرشاد البنية المتناثرة.

الافتراضي 1

استخدم كسر إزالة تشويش يساوي أو يتجاوز `ss_guidance_interval_start` لتحديد وقت توقف إرشاد البنية المتناثرة.

الافتراضي 12

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

الافتراضي 5

حدة جدول الضوضاء أثناء توليد البنية المتناثرة.

الافتراضي 7.5

قوة الإرشاد الخالي من المصنّف أثناء توليد الشكل.

الافتراضي 0.5

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

الافتراضي 0.6

كسر إزالة التشويش الذي يبدأ عنده إرشاد مرحلة الشكل.

الافتراضي 1

نقطة توقف إرشاد مرحلة الشكل، معبرًا عنها بكسر إزالة تشويش لا يقل عن shape_slat_guidance_interval_start.

الافتراضي 12

عدد خطوات إزالة التشويش أثناء توليد الشكل.

الافتراضي 3

حدة جدول الضوضاء أثناء توليد الشكل.

الافتراضي 1

قوة الإرشاد الخالي من المصنّف أثناء توليد الخامة.

الافتراضي 0

إعادة التحجيم المطبقة على الإرشاد أثناء توليد الخامة؛ ارفعها عندما تبدو الخامات مشوشة.

الافتراضي 0.6

كسر إزالة التشويش الذي يبدأ عنده إرشاد مرحلة الخامة.

الافتراضي 0.9

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

الافتراضي 12

عدد خطوات إزالة التشويش أثناء توليد الخامة.

الافتراضي 3

حدة جدول الضوضاء أثناء توليد الخامة.

الافتراضي 500000

العدد المطلوب للرؤوس في تصدير GLB.

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

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

ينشئ GLB من `image_url`، مع إمكانية تطبيق LoRA بصيغة safetensors عبر `sparse_structure_lora_url` و`geometry_lora_url` و`texture_lora_url`. تكون `resolution` بقيمة 512 أو 1024 ويجب أن تطابق دقة تدريب المحولات. كما يوفّر عناصر تحكم في التوجيه والخطوات لكل مرحلة، و`decimation_target` و`texture_size`.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة المصدر لتحويلها إلى نموذج ثلاثي الأبعاد.
sparse_structure_lora_urlاختياري
النوعstring | null
نقطة فحص LoRA اختيارية بتنسيق safetensors، مدرَّبة خصيصًا لمزيل تشويش البنية المتناثرة.
geometry_lora_urlاختياري
النوعstring | null
نقطة فحص LoRA اختيارية بتنسيق safetensors، مدرَّبة خصيصًا لمزيل تشويش الهندسة.
texture_lora_urlاختياري
النوعstring | null
نقطة فحص LoRA اختيارية بتنسيق safetensors، مدرَّبة خصيصًا لمزيل تشويش الخامة.
seedاختياري
النوعinteger | null
بذرة عشوائية تجعل التوليد قابلاً لإعادة الإنتاج.
resolutionاختياري
النوعenum
الافتراضي512
5121024
دقة التوليد، حيث يختار 1024 خط أنابيب التتابع. اختر الدقة المستخدمة لتدريب محولات LoRA المقدمة؛ ويجب التطابق.
ss_guidance_strengthاختياري
النوعnumber
الافتراضي7.5
0 – 10
قوة الإرشاد الخالي من المصنّف أثناء توليد البنية المتناثرة.
ss_guidance_rescaleاختياري
النوعnumber
الافتراضي0.7
0 – 1
إعادة تحجيم الإرشاد أثناء توليد البنية المتناثرة. تجعل القيم الأكبر المخرج أكثر استقرارًا.
ss_guidance_interval_startاختياري
النوعnumber
الافتراضي0.6
0 – 1
كسر تقدم إزالة التشويش الذي يبدأ عنده إرشاد البنية المتناثرة.
ss_guidance_interval_endاختياري
النوعnumber
الافتراضي1
0 – 1
استخدم كسر إزالة تشويش يساوي أو يتجاوز `ss_guidance_interval_start` لتحديد وقت توقف إرشاد البنية المتناثرة.
ss_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات إزالة التشويش المستخدمة أثناء توليد البنية المتناثرة.
ss_rescale_tاختياري
النوعnumber
الافتراضي5
1 – 6
حدة جدول الضوضاء أثناء توليد البنية المتناثرة.
shape_slat_guidance_strengthاختياري
النوعnumber
الافتراضي7.5
0 – 10
قوة الإرشاد الخالي من المصنّف أثناء توليد الشكل.
shape_slat_guidance_rescaleاختياري
النوعnumber
الافتراضي0.5
0 – 1
إعادة التحجيم المطبقة على الإرشاد أثناء توليد الشكل؛ ارفعها عندما تبدو الهندسة مشوشة.
shape_slat_guidance_interval_startاختياري
النوعnumber
الافتراضي0.6
0 – 1
كسر إزالة التشويش الذي يبدأ عنده إرشاد مرحلة الشكل.
shape_slat_guidance_interval_endاختياري
النوعnumber
الافتراضي1
0 – 1
نقطة توقف إرشاد مرحلة الشكل، معبرًا عنها بكسر إزالة تشويش لا يقل عن shape_slat_guidance_interval_start.
shape_slat_sampling_stepsاختياري
النوعinteger
الافتراضي12
1 – 50
عدد خطوات إزالة التشويش أثناء توليد الشكل.
shape_slat_rescale_tاختياري
النوعnumber
الافتراضي3
1 – 6
حدة جدول الضوضاء أثناء توليد الشكل.
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
كسر إزالة التشويش الذي يبدأ عنده إرشاد مرحلة الخامة.
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
حدة جدول الضوضاء أثناء توليد الخامة.
decimation_targetاختياري
النوعinteger
الافتراضي500000
5,000 – 2,000,000
العدد المطلوب للرؤوس في تصدير GLB.
texture_sizeاختياري
النوعenum
الافتراضي2048
102420484096
دقة الخامات المخبوزة في تصدير GLB.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "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": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "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_glb
object {url, content_type, file_name, file_size}ملف GLB يحتوي على النموذج ثلاثي الأبعاد المُولَّد.
seed
integerالبذرة المطبقة أثناء التوليد.
resolution
integerالدقة التي أُجري عندها التوليد.
sparse_structure_lora_url
string | nullنقطة فحص LoRA للبنية المتناثرة المستخدمة أثناء التوليد، إن طُبقت.
geometry_lora_url
string | nullنقطة فحص LoRA للهندسة المستخدمة أثناء التوليد، إن طُبقت.
texture_lora_url
string | nullنقطة فحص LoRA للخامة المستخدمة أثناء التوليد، إن طُبقت.
decimation_target
integerهدف عدد الرؤوس المطبق على تصدير GLB.
texture_size
integerدقة الخامات المخبوزة في تصدير GLB.

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