رفتن به محتوا

PATINA · Material · Extract

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

شناسه مدل patina/material/extract
# 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/patina/material/extract?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
Open model ویرایش تصویر #material#pbr#extraction

بافت قابل‌تکرار را همراه با نقشه‌های PBR از تصویر منبع استخراج می‌کند و پرامپت سطح موردنظر را مشخص می‌کند

Open model · تصویر

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

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

ساخت درخواست

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

•الزامی

توضیح بافت موردنظر برای استخراج از تصویر.

•الزامی image_url
یک فایل بیندازید، یا

URL تصویر منبع برای استخراج بافت.

image_size پیش‌فرض square_hd

ابعاد پیکسلی بافت حاصل.

upscale_factor پیش‌فرض 0

ضریب بزرگ‌نمایی بدون درز SeedVR که بر نقشه‌های PBR پیش‌بینی‌شده اثر می‌گذارد، اما بافت پایه را در وضوح اصلی نگه می‌دارد. برای وضوح دوبرابر 2، برای وضوح چهاربرابر 4 و برای غیرفعال‌کردن بزرگ‌نمایی 0 را انتخاب کنید.

num_images پیش‌فرض 1

تعداد تصاویر بافتی که باید ایجاد شوند.

پیشرفته tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
tiling_mode پیش‌فرض both

جهت کاشی‌کاری: 'both' برای کاشی‌کاری همه‌جهته، 'horizontal' یا 'vertical'.

output_format پیش‌فرض png

قالب فایل تصویر برای بافت‌ها و نقشه‌های PBR خروجی.

پیش‌فرض 8

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

پیش‌فرض 128

اندازه کاشی در فضای نهفته؛ 64 نشان‌دهنده 512px و 128 نشان‌دهنده 1024px است. در هر محور کاشی‌شده، بُعد تصویر تولیدشده سقف خودکار را تعیین می‌کند.

پیش‌فرض 64

گام بین کاشی‌های فضای نهفته را تعیین کنید؛ سقف خودکار مانع از بیشترشدن آن از نصف اندازه مؤثر کاشی می‌شود.

پیش‌فرض 0.6

قدرت تبدیل که فقط روی تصویر ارائه‌شده از طریق image_url اعمال می‌شود؛ در غیر این صورت استفاده نمی‌شود.

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

پیش‌فرض ["basecolor","normal"...

نقشه‌های PBR انتخاب‌شده برای پیش‌بینی؛ هر پنج مورد به‌صورت پیش‌فرض انتخاب می‌شوند. انتخاب هیچ‌کدام، برآورد PBR را کاملاً رد می‌کند.

POST /run/patina/material/extract?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/patina/material/extract?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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

درباره PATINA · Material · Extract

یک تصویر ورودی و پرامپتی درباره سطح موردنظر برای استخراج دریافت و بافتی قابل‌تکرار همراه با نقشه‌های PBR پیش‌بینی‌شده برمی‌گرداند. `maps` تعیین می‌کند کدام‌یک از basecolor، normal، roughness، metalness و height تولید شوند. گزینه‌ها شامل `tiling_mode`، `strength` از 0 تا 1، `upscale_factor` برابر 0، 2 یا 4 و 1 تا 4 خروجی هستند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
توضیح بافت موردنظر برای استخراج از تصویر.
image_sizeاختیاری
نوعobject
پیش‌فرضsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد پیکسلی بافت حاصل.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض8
۱ – ۸
تعداد گام‌های حذف نویز استفاده‌شده برای تولید بافت‌ها.
seedاختیاری
نوعinteger | null
seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر بافتی که باید ایجاد شوند.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضtrue
بسط پرامپت مبتنی بر LLM را برای افزودن جزئیات فعال می‌کند.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
بررسی ایمنی تصاویر تولیدشده را فعال می‌کند.
tiling_modeاختیاری
نوعenum
پیش‌فرضboth
bothhorizontalvertical
جهت کاشی‌کاری: 'both' برای کاشی‌کاری همه‌جهته، 'horizontal' یا 'vertical'.
tile_sizeاختیاری
نوعinteger
پیش‌فرض128
۳۲ – ۲۵۶
اندازه کاشی در فضای نهفته؛ 64 نشان‌دهنده 512px و 128 نشان‌دهنده 1024px است. در هر محور کاشی‌شده، بُعد تصویر تولیدشده سقف خودکار را تعیین می‌کند.
tile_strideاختیاری
نوعinteger
پیش‌فرض64
۱۶ – ۱۲۸
گام بین کاشی‌های فضای نهفته را تعیین کنید؛ سقف خودکار مانع از بیشترشدن آن از نصف اندازه مؤثر کاشی می‌شود.
image_urlالزامی image
نوعurl · image
URL تصویر منبع برای استخراج بافت.
strengthاختیاری
نوعnumber
پیش‌فرض0.6
≤ ۱> ۰
قدرت تبدیل که فقط روی تصویر ارائه‌شده از طریق image_url اعمال می‌شود؛ در غیر این صورت استفاده نمی‌شود.
mapsاختیاری
نوعenum[]
پیش‌فرض["basecolor","normal","roughness","metalness","height"]
نقشه‌های PBR انتخاب‌شده برای پیش‌بینی؛ هر پنج مورد به‌صورت پیش‌فرض انتخاب می‌شوند. انتخاب هیچ‌کدام، برآورد PBR را کاملاً رد می‌کند.
upscale_factorاختیاری
نوعenum
پیش‌فرض0
024
ضریب بزرگ‌نمایی بدون درز SeedVR که بر نقشه‌های PBR پیش‌بینی‌شده اثر می‌گذارد، اما بافت پایه را در وضوح اصلی نگه می‌دارد. برای وضوح دوبرابر 2، برای وضوح چهاربرابر 4 و برای غیرفعال‌کردن بزرگ‌نمایی 0 را انتخاب کنید.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر برای بافت‌ها و نقشه‌های PBR خروجی.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "patina/material/extract",
  "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": 170,
    "usd": "0.17",
    "charged": 170,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of anyتصاویر خروجی شامل نقشه‌های مواد PBR پیش‌بینی‌شده توسط PATINA در کنار بافت‌های کاشی‌پذیر تولیدشده توسط z-image هستند.
seed
integerseed اعمال‌شده هنگام تولید بافت‌ها.
prompt
stringپرامپت تولید بافت، شامل هرگونه بسط اعمال‌شده.
timings
objectجزئیات زمان‌بندی کل فرایند، برحسب ثانیه.

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

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