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

PATINA · Material

التكامل

معرّف النموذج patina/material
# 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/patina/material?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"
  }'

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

ملفات مثل المثال: ⁨‏0.08 $⁩ 80 رصيد API · ≈ ⁨‏8.44 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model من نص إلى صورة #material#pbr#displacement#metalness

مولّد نص إلى خامة ينتج صورًا قابلة للتكرار مع خرائط PBR، ويدعم اختياريًا img2img وinpainting

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب

وصف نصي للمادة أو النسيج المطلوب إنشاؤه.

image_size الافتراضي square_hd

أبعاد البكسل للنسيج الناتج.

upscale_factor الافتراضي 0

عامل رفع الدقة السلس لـ SeedVR الذي يؤثر في خرائط PBR المتنبأ بها، مع إبقاء النسيج الأساسي بدقته الأصلية. اختر 2 لمضاعفة الدقة، أو 4 لمضاعفتها أربع مرات، أو 0 لتعطيل رفع الدقة.

num_images الافتراضي 1

عدد صور الأنسجة المطلوب إنشاؤها.

متقدم image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
أفلت ملفًا، أو

عنوان URL للصورة المصدر، يُستخدم للرسم الداخلي إذا كان mask_url مصاحباً له، وللمعالجة من صورة إلى صورة خلاف ذلك.

mask_url
أفلت ملفًا، أو

عنوان URL لقناع الرسم الداخلي المقدّم بجانب image_url المطلوب. يحافظ القناع على المناطق السوداء دون تغيير ويعيد توليد المناطق البيضاء.

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?wait=20 عرض السعر → ⁨‏0.08 $⁩
# 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/patina/material?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"
  }'

# 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

حول PATINA · Material

ينشئ خامات قابلة للتبليط من موجّه ويتنبأ بخرائط PBR: basecolor وnormal وroughness وmetalness وheight. استخدم `tiling_mode` للتبليط في الاتجاهين أو الأفقي أو العمودي، و`upscale_factor` بقيمة 0 أو 2 أو 4 لتكبير الخرائط. يفعّل تمرير `image_url` التحويل من صورة إلى صورة، وتفعيل `mask_url` الرسم الداخلي. حتى 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 للصورة المصدر، يُستخدم للرسم الداخلي إذا كان mask_url مصاحباً له، وللمعالجة من صورة إلى صورة خلاف ذلك.
mask_urlاختياري mask
النوع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",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt