رفتن به محتوا

TRELLIS.2 Trainer

یکپارچه‌سازی

شناسه مدل trellis-2-lora-trainer
# 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-lora-trainer?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data_url": "https://example.com/your-file.zip"
  }'

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

فایل‌هایی مانند نمونه: ⁨‎$۱۵٫۹۷۳⁩ ۱۵٬۹۷۳ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Microsoft آموزش

آموزش آداپترهای LoRA برای Trellis 2 روی فایل zip دارایی‌های سه‌بعدی، برای حداکثر سه نویززدا

Microsoft · فایل

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

resolution پیش‌فرض 512

وضوح آموزش باید با وضوح پیش‌پردازش مجموعه‌داده برابر باشد. آموزش هندسه و بافت هرکدام پیکربندی‌های جداگانه برای 512 و 1024 دارند، درحالی‌که آموزش ساختار پراکنده پیکربندی مشترکی در این وضوح‌ها دارد.

rank پیش‌فرض 32

رتبه مبدل LoRA؛ مقادیر بزرگ‌تر ظرفیت بیشتری برای مبدل فراهم می‌کنند.

•الزامی

URL آرشیو مجموعه‌داده: دارایی‌های خام سه‌بعدی بسته‌بندی‌شده به‌صورت .zip را ارائه کنید، یا از zip مجموعه‌داده ازپیش‌پردازش‌شده TRELLIS.2 برگشتی از data_preprocessing استفاده کنید.

پیش‌فرض 1000

تعداد کل گام‌های آموزش.

انتخاب 1–3 حذف‌کننده نویز متفاوت TRELLIS.2 از sparse_structure، geometry و texture برای تنظیم دقیق. آموزش موازی از مجموعه‌داده مشترک ازپیش‌پردازش‌شده استفاده می‌کند تا برای هر ورودی انتخاب‌شده یک مبدل LoRA جداگانه تولید کند.

پیشرفته learning_rate
پیش‌فرض 0.0001

نرخ یادگیری برای بهینه‌سازی LoRA.

POST /run/trellis-2-lora-trainer?wait=20 قیمت → ⁨‎$۱۵٫۹۷۳⁩
# 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-lora-trainer?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data_url": "https://example.com/your-file.zip"
  }'

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

آداپترها را از فایل zip موجود در `data_url` تنظیم دقیق می‌کند؛ این فایل می‌تواند شامل دارایی‌های خام سه‌بعدی یا مجموعه‌داده پیش‌پردازش‌شده باشد. `denoisers` تعداد 1 تا 3 هدف را انتخاب می‌کند که هرکدام به‌عنوان آداپتری مستقل آموزش می‌بینند. تنظیمات: `resolution` برابر 512 یا 1024، `rank` برابر 16، 32 یا 64، `learning_rate` و `training_steps` از 100 تا 10000. آداپترها، خطاهای احتمالی و داده پیش‌پردازش‌شده قابل استفاده مجدد را برمی‌گرداند.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
data_urlالزامی
نوعstring
URL آرشیو مجموعه‌داده: دارایی‌های خام سه‌بعدی بسته‌بندی‌شده به‌صورت .zip را ارائه کنید، یا از zip مجموعه‌داده ازپیش‌پردازش‌شده TRELLIS.2 برگشتی از data_preprocessing استفاده کنید.
denoisersاختیاری
نوعenum[]
≤ ۳ مورد
انتخاب 1–3 حذف‌کننده نویز متفاوت TRELLIS.2 از sparse_structure، geometry و texture برای تنظیم دقیق. آموزش موازی از مجموعه‌داده مشترک ازپیش‌پردازش‌شده استفاده می‌کند تا برای هر ورودی انتخاب‌شده یک مبدل LoRA جداگانه تولید کند.
resolutionاختیاری
نوعenum
پیش‌فرض512
5121024
وضوح آموزش باید با وضوح پیش‌پردازش مجموعه‌داده برابر باشد. آموزش هندسه و بافت هرکدام پیکربندی‌های جداگانه برای 512 و 1024 دارند، درحالی‌که آموزش ساختار پراکنده پیکربندی مشترکی در این وضوح‌ها دارد.
rankاختیاری
نوعenum
پیش‌فرض32
163264
رتبه مبدل LoRA؛ مقادیر بزرگ‌تر ظرفیت بیشتری برای مبدل فراهم می‌کنند.
learning_rateاختیاری
نوعnumber
پیش‌فرض0.0001
۰٫۰۰۰۰۰۱ – ۰٫۰۱
نرخ یادگیری برای بهینه‌سازی LoRA.
training_stepsاختیاری
نوعinteger
پیش‌فرض1000
۱۰۰ – ۱۰٬۰۰۰
تعداد کل گام‌های آموزش.
الزامی

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora-trainer",
  "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": 15973,
    "usd": "15.973",
    "charged": 15973,
    "refunded": 0
  },
  "input": {
    "data_url": "https://example.com/your-file.zip"
  },
  "output": {
    "adapters": [
      {
        "denoiser": "sparse_structure",
        "resolution": 1,
        "lora_file": {
          "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
        },
        "rank": 1,
        "training_steps": 1,
        "learning_rate": 1.0
      }
    ],
    "failed": [
      {
        "denoiser": "sparse_structure",
        "error": "string"
      }
    ],
    "preprocessed_data_file": {
      "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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
adapters
array of object {denoiser, resolution, lora_file, rank, training_steps, learning_rate}فایل‌های مبدل LoRA نگاشت‌شده به فیلدهای متناظر استنتاج trellis-2-lora. پاسخ برای هر حذف‌کننده نویزی که آموزش آن موفق بوده یک مبدل دارد؛ فایل آن را در فیلد متناظر استفاده کنید.
failed
array of object {denoiser, error}نتایج آموزش ناموفق حذف‌کننده‌های نویز؛ فقط حذف‌کننده‌هایی که آموزششان کامل نشده در اینجا ظاهر می‌شوند، بنابراین موفقیت همه حذف‌کننده‌های درخواستی این فیلد را خالی می‌گذارد.
preprocessed_data_file
object {url, content_type, file_name, file_size}zip مجموعه‌داده TRELLIS.2 ازپیش‌پردازش‌شده که هنگام آموزش استفاده شده و برای استفاده مجدد در دسترس است.

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/trellis-2-lora-trainer.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt