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

Marigold V2 Depth

التكامل

معرّف النموذج marigold-v2
# 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/marigold-v2?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.03 $⁩ 30 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model تحرير الصور #depth#utility

نموذج لتحليل الصور ينتج خرائط العمق أو العمق الشفاف أو المتجهات العمودية أو البياض من صورة واحدة

Open model · صورة

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

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

إنشاء طلب

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

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

URL لصورة المدخل.

image_size

أبعاد الاستدلال؛ يؤدي حذفها إلى استخدام حجم صورة المدخل بعد تقريب كل بُعد إلى أقرب مضاعف للعدد 16. حدّد إعدادًا مسبقًا مثل `"square_hd"` أو `"landscape_4_3"`، أو وفّر كائن `{width, height}`. يجب أن يكون العرض والارتفاع قابلين للقسمة على 16، وألا يتجاوز أي منهما 2048 بكسل، وأن تقع النسبة بين 1:16 و16:1.

متقدم prediction_type · seed · enable_safety_checker
prediction_type الافتراضي depth

نوع خريطة التنبؤ المطلوب إنتاجها.

بذرة عشوائية تجعل المخرج قابلاً لإعادة الإنتاج عند إعادة استخدام الصورة نفسها. يقتصر تأثيرها على أخذ العينات الكامنة في مُرمِّز VAE، لأن المرور الأمامي خطوة حتمية بحد ذاته.

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

حول Marigold V2 Depth

يقدّر خريطة من صورة واحدة. يحدد `prediction_type` العمق أو العمق الشفاف أو النورمال أو الألبيدو. النتيجة تصور بصيغة PNG وليست موترًا رقميًا. يمكن أن تكون `image_size` قيمة مسبقة أو كائن عرض/ارتفاع بمضاعفات 16 حتى 2048، ويجعل `seed` النتائج قابلة للتكرار.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
prediction_typeاختياري
النوعenum
الافتراضيdepth
depthsee-through-depthnormalsalbedo
نوع خريطة التنبؤ المطلوب إنتاجها.
image_urlمطلوب image
النوعurl · image
URL لصورة المدخل.
image_sizeاختياري
النوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الاستدلال؛ يؤدي حذفها إلى استخدام حجم صورة المدخل بعد تقريب كل بُعد إلى أقرب مضاعف للعدد 16. حدّد إعدادًا مسبقًا مثل `"square_hd"` أو `"landscape_4_3"`، أو وفّر كائن `{width, height}`. يجب أن يكون العرض والارتفاع قابلين للقسمة على 16، وألا يتجاوز أي منهما 2048 بكسل، وأن تقع النسبة بين 1:16 و16:1.
seedاختياري
النوعinteger | null
بذرة عشوائية تجعل المخرج قابلاً لإعادة الإنتاج عند إعادة استخدام الصورة نفسها. يقتصر تأثيرها على أخذ العينات الكامنة في مُرمِّز VAE، لأن المرور الأمامي خطوة حتمية بحد ذاته.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "marigold-v2",
  "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": 30,
    "usd": "0.03",
    "charged": 30,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
  },
  "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size, width, height}تنبؤ مُصيَّر بصيغة PNG للعرض؛ لا يوفّر الرد موترًا عدديًا غير فاقد عبر هذه الصورة.
seed
integerالبذرة المطبقة عند أخذ العينات الكامنة في مُرمِّز VAE.

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