رفتن به محتوا

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

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

دریافت کلید API
Microsoft تصویر به 3D #image-to-3d

بافت‌دهی دوباره مش سه‌بعدی بدون بافت برای تطبیق با تصویر مرجع و خروجی GLB

Microsoft · 3D

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

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

ساخت درخواست

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

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

وضوح بافت مش برای baking. افزایش وضوح، جزئیات سطحی ظریف‌تر اما فایل‌های بزرگ‌تری ایجاد می‌کند.

پیش‌فرض 1

کنترل وفاداری رنگ بافت؛ پایبندی بیشتر به رنگ‌های تصویر ورودی در تنظیمات بالاتر، شادابی را افزایش می‌دهد اما ممکن است باعث اشباع بیش‌ازحد شود.

پیش‌فرض 0

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

پیش‌فرض 0.6

نقطه فعال‌سازی راهنمایی بدون دسته‌بندی برای تولید بافت. این مقدار به‌صورت کسری از پیشرفت حذف نویز، interval_start را تعیین می‌کند؛ راهنمایی فقط در پنجره میان interval_start و interval_end انجام می‌شود.

پیش‌فرض 0.9

مرز توقف راهنمایی بدون دسته‌بندی مرحله بافت، به‌صورت کسری از حذف نویز که کمتر از tex_slat_guidance_interval_start نیست.

پیش‌فرض 12

تعداد گام‌های حذف نویز برای تولید بافت‌ها. افزایش تعداد گام‌ها زمان بیشتری می‌برد اما ممکن است بافت‌های پاک‌تری ایجاد کند.

پیش‌فرض 3

وضوح جزئیات بافت را از طریق زمان‌بندی نویز تولید بافت تعیین کنید؛ افزایش این مقدار جزئیات را واضح‌تر می‌کند.

seed استفاده‌شده برای تولید تصادفی تکرارپذیر.

POST /run/trellis-2/retexture?wait=20 قیمت → ⁨‎$۰٫۲۴⁩
# 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/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

درباره Trellis 2 · Retexture

بر اساس تصویر مرجع `image_url`، بافت جدیدی روی مش موجود در `mesh_url` (GLB، OBJ، PLY یا STL) اعمال می‌کند. `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
seed استفاده‌شده برای تولید تصادفی تکرارپذیر.
resolutionاختیاری
نوعenum
پیش‌فرض1024
5121024
جزئیات بافت و سرعت پردازش به این وضوح داخلی تولید بستگی دارد: افزایش آن جزئیات ظریف‌تری ایجاد می‌کند اما زمان بیشتری می‌برد.
tex_slat_guidance_strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱۰
کنترل وفاداری رنگ بافت؛ پایبندی بیشتر به رنگ‌های تصویر ورودی در تنظیمات بالاتر، شادابی را افزایش می‌دهد اما ممکن است باعث اشباع بیش‌ازحد شود.
tex_slat_guidance_rescaleاختیاری
نوعnumber
پیش‌فرض0
۰ – ۱
برای رفع بافت‌های نویزی یا نوارشدگی رنگ این تنظیم را افزایش دهید؛ مصنوعات ناشی از هدایت قوی در مرحله بافت را کاهش می‌دهد.
tex_slat_guidance_interval_startاختیاری
نوعnumber
پیش‌فرض0.6
۰ – ۱
نقطه فعال‌سازی راهنمایی بدون دسته‌بندی برای تولید بافت. این مقدار به‌صورت کسری از پیشرفت حذف نویز، interval_start را تعیین می‌کند؛ راهنمایی فقط در پنجره میان interval_start و interval_end انجام می‌شود.
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
۱ – ۶
وضوح جزئیات بافت را از طریق زمان‌بندی نویز تولید بافت تعیین کنید؛ افزایش این مقدار جزئیات را واضح‌تر می‌کند.
texture_sizeاختیاری
نوعenum
پیش‌فرض2048
102420484096
وضوح بافت مش برای baking. افزایش وضوح، جزئیات سطحی ظریف‌تر اما فایل‌های بزرگ‌تری ایجاد می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}مدل 3D تولیدشده در قالب GLB.

مدل‌های بیشتر: تصویر به 3D

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