رفتن به محتوا

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۲۵⁩ ۲۵۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Microsoft تصویر به 3D

تبدیل تصویر به سه‌بعدی با Trellis 2 و اعمال آداپترهای سفارشی LoRA برای ساختار، هندسه و بافت

Microsoft · 3D

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

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

ساخت درخواست

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

•الزامی 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.

seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.

POST /run/trellis-2-lora?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?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره TRELLIS.2 LoRA Inference

از `image_url` یک GLB تولید می‌کند و در صورت نیاز 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
seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.
resolutionاختیاری
نوعenum
پیش‌فرض512
5121024
وضوح تولید؛ مقدار 1024 خط لوله آبشاری را انتخاب می‌کند. وضوح استفاده‌شده برای آموزش مبدل‌های LoRA ارائه‌شده را انتخاب کنید؛ تطابق الزامی است.
ss_guidance_strengthاختیاری
نوعnumber
پیش‌فرض7.5
۰ – ۱۰
قدرت راهنمایی بدون دسته‌بندی هنگام تولید ساختار پراکنده.
ss_guidance_rescaleاختیاری
نوعnumber
پیش‌فرض0.7
۰ – ۱
بازمقیاس‌گذاری راهنمایی هنگام تولید ساختار پراکنده. مقادیر بیشتر خروجی را پایدارتر می‌کنند.
ss_guidance_interval_startاختیاری
نوعnumber
پیش‌فرض0.6
۰ – ۱
کسری از پیشرفت حذف نویز که راهنمایی ساختار پراکنده در آن آغاز می‌شود.
ss_guidance_interval_endاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
برای مشخص‌کردن زمان توقف راهنمایی ساختار پراکنده، از کسری از حذف نویز برابر یا بیشتر از `ss_guidance_interval_start` استفاده کنید.
ss_sampling_stepsاختیاری
نوعinteger
پیش‌فرض12
۱ – ۵۰
تعداد گام‌های حذف نویز هنگام تولید ساختار پراکنده.
ss_rescale_tاختیاری
نوعnumber
پیش‌فرض5
۱ – ۶
وضوح زمان‌بندی نویز هنگام تولید ساختار پراکنده.
shape_slat_guidance_strengthاختیاری
نوعnumber
پیش‌فرض7.5
۰ – ۱۰
قدرت راهنمایی بدون دسته‌بندی هنگام تولید شکل.
shape_slat_guidance_rescaleاختیاری
نوعnumber
پیش‌فرض0.5
۰ – ۱
بازمقیاس‌گذاری اعمال‌شده به راهنمایی هنگام تولید شکل؛ وقتی هندسه نویزی است آن را افزایش دهید.
shape_slat_guidance_interval_startاختیاری
نوعnumber
پیش‌فرض0.6
۰ – ۱
کسری از حذف نویز که راهنمایی مرحله شکل در آن آغاز می‌شود.
shape_slat_guidance_interval_endاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
نقطه توقف راهنمایی مرحله شکل، به‌صورت کسری از حذف نویز که کمتر از shape_slat_guidance_interval_start نیست.
shape_slat_sampling_stepsاختیاری
نوعinteger
پیش‌فرض12
۱ – ۵۰
تعداد گام‌های حذف نویز هنگام تولید شکل.
shape_slat_rescale_tاختیاری
نوعnumber
پیش‌فرض3
۱ – ۶
وضوح زمان‌بندی نویز هنگام تولید شکل.
tex_slat_guidance_strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱۰
قدرت راهنمایی بدون دسته‌بندی هنگام تولید بافت.
tex_slat_guidance_rescaleاختیاری
نوعnumber
پیش‌فرض0
۰ – ۱
بازمقیاس‌گذاری اعمال‌شده به راهنمایی هنگام تولید بافت؛ وقتی بافت‌ها نویزی هستند آن را افزایش دهید.
tex_slat_guidance_interval_startاختیاری
نوعnumber
پیش‌فرض0.6
۰ – ۱
کسری از حذف نویز که راهنمایی مرحله بافت در آن آغاز می‌شود.
tex_slat_guidance_interval_endاختیاری
نوعnumber
پیش‌فرض0.9
۰ – ۱
نقطه توقف راهنمایی مرحله بافت، به‌صورت کسری از حذف نویز که کمتر از tex_slat_guidance_interval_start نیست.
tex_slat_sampling_stepsاختیاری
نوعinteger
پیش‌فرض12
۱ – ۵۰
تعداد گام‌های حذف نویز هنگام تولید بافت.
tex_slat_rescale_tاختیاری
نوعnumber
پیش‌فرض3
۱ – ۶
وضوح زمان‌بندی نویز هنگام تولید بافت.
decimation_targetاختیاری
نوعinteger
پیش‌فرض500000
۵٬۰۰۰ – ۲٬۰۰۰٬۰۰۰
تعداد مطلوب رأس‌ها در خروجی 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.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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
model_glb
object {url, content_type, file_name, file_size}فایل GLB حاوی مدل سه‌بعدی تولیدشده.
seed
integerseed اعمال‌شده هنگام تولید.
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/fa/developers/models/trellis-2-lora.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt