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

PATINA

التكامل

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

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

الحصول على مفتاح API
Open model تحرير الصور #pbr#displacement#metalness#normal

يتنبأ بخرائط مواد PBR (basecolor وnormal وroughness وmetalness وheight) من صورة واحدة

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL يشير إلى صورة فوتوغرافية أو تصميم مُقدّم كمدخل.

متقدم output_format · seed · enable_safety_checker · maps
output_format الافتراضي png

تنسيق الصورة الناتجة.

بذرة إزالة التشويش، تُختار عشوائياً عند حذفها؛ يتيح تقديم قيمة تنفيذ إزالة تشويش قابلة لإعادة الإنتاج.

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

خرائط PBR المحددة للتنبؤ؛ تُحدد الخرائط الخمس افتراضياً.

POST /run/patina?wait=20 عرض السعر → ⁨‏0.06 $⁩
# 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?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

حول PATINA

يحوّل صورة فوتوغرافية أو تصييرًا إلى خرائط مواد لأعمال 3D وإكساء النماذج. استخدم `maps` لاختيار إنتاج basecolor أو normal أو roughness أو metalness أو height؛ والخمس كلها افتراضيًا. يمكن أن يكون الناتج PNG أو JPEG أو WebP، وتوفّر `seed` إزالة ضوضاء قابلة لإعادة الإنتاج. يعيد صورة واحدة لكل خريطة مطلوبة.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL يشير إلى صورة فوتوغرافية أو تصميم مُقدّم كمدخل.
mapsاختياري
النوعenum[]
الافتراضي["basecolor","normal","roughness","metalness","height"]
خرائط PBR المحددة للتنبؤ؛ تُحدد الخرائط الخمس افتراضياً.
seedاختياري
النوعinteger | null
بذرة إزالة التشويش، تُختار عشوائياً عند حذفها؛ يتيح تقديم قيمة تنفيذ إزالة تشويش قابلة لإعادة الإنتاج.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكّن فحص سلامة الصورة.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpngwebp
تنسيق الصورة الناتجة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "patina",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "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,
        "map_type": "basecolor"
      }
    ],
    "timings": {},
    "seed": 42
  },
  "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 object {url, content_type, file_name, file_size, width, height, map_type}خرائط مواد PBR الناتجة عن التنبؤ.
timings
objectأوقات المعالجة مقسّمة بالثواني.
seed
integerالبذرة المطبقة أثناء إزالة التشويش.

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

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