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

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"

ملفات مثل المثال: ⁨‏0.17 $⁩ 170 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model تحرير الصور #material#pbr#extraction

يستخرج خامة قابلة للتكرار مع خرائط PBR من صورة مصدر، بتوجيه من مطالبة تسمّي السطح

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب

وصف النسيج المطلوب استخراجه من الصورة.

•مطلوب 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؛ ولا تُستخدم خلاف ذلك.

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

الافتراضي ["basecolor","normal"...

خرائط PBR المحددة للتنبؤ، مع تحديد الخرائط الخمس افتراضياً. يؤدي عدم تحديد أي خريطة إلى تخطي تقدير PBR بالكامل.

POST /run/patina/material/extract?wait=20 عرض السعر → ⁨‏0.17 $⁩
# 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
1 – 8
عدد خطوات إزالة التشويش المستخدمة لتوليد الأنسجة.
seedاختياري
النوعinteger | null
بذرة عشوائية تجعل التوليد قابلاً لإعادة الإنتاج.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد صور الأنسجة المطلوب إنشاؤها.
enable_prompt_expansionاختياري
النوعboolean
الافتراضيtrue
يمكّن توسيع الموجّه المستند إلى LLM لإضافة التفاصيل.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكّن فحص سلامة الصور المُولّدة.
tiling_modeاختياري
النوعenum
الافتراضيboth
bothhorizontalvertical
اتجاه التبليط: 'both' للتبليط متعدد الاتجاهات، أو 'horizontal'، أو 'vertical'.
tile_sizeاختياري
النوعinteger
الافتراضي128
32 – 256
حجم البلاطة في الفضاء الكامن، حيث تمثل 64 قيمة 512px وتمثل 128 قيمة 1024px. يحدد بُعد الصورة المُولّدة على كل محور مُبلّط حداً أعلى تلقائياً.
tile_strideاختياري
النوعinteger
الافتراضي64
16 – 128
حدد المسافة بين البلاطات في الفضاء الكامن؛ يمنع حد تلقائي تجاوز نصف حجم البلاطة الفعلي.
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المصدر لاستخراج النسيج.
strengthاختياري
النوعnumber
الافتراضي0.6
≤ 1> 0
قوة التحويل المطبقة فقط على صورة مقدّمة عبر 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of anyتتضمن صور المخرج خرائط مواد PBR المتنبأ بها بواسطة PATINA إلى جانب الأنسجة القابلة للتبليط المُولّدة بواسطة z-image.
seed
integerالبذرة المطبقة عند توليد الأنسجة.
prompt
stringموجّه توليد النسيج، بما في ذلك أي توسعة مطبقة.
timings
objectتفصيل التوقيت الذي يغطي العملية بأكملها، بالثواني.

مزيد من النماذج: تحرير الصور

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