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

Workflow Utilities Pick Image By Index

التكامل

معرّف النموذج workflow-utilities/pick-image-by-index
# 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/workflow-utilities/pick-image-by-index?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "index": 1
  }'

# 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.001 $⁩ 1 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Utility · صورة

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

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

إنشاء طلب

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

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

مصفوفة عناوين URL للصور المستخدمة كمصدر للاختيار.

•مطلوب

اختيار الصورة حسب الموضع، بدءًا من 1: اطلب 1 للصورة الأولى، و2 للثانية، وهكذا.

متقدم fallback_index
fallback_index الافتراضي first-image

سياسة اختيار الصور خارج النطاق، وقيمتها الافتراضية `first-image`؛ يتم تجاهلها عند صحة `index`، مع استمرار فشل التحقق عند كون `index` أقل من 1 أو مصفوفة `image_urls` فارغة. لا تفعّل السياسة إلا قيمة `index` التي تتجاوز طول المصفوفة: تختار `first-image` الصورة الأولى، بينما تختار `last-image` الصورة الأخيرة.

POST /run/workflow-utilities/pick-image-by-index?wait=20 عرض السعر → ⁨‏0.001 $⁩
# 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/workflow-utilities/pick-image-by-index?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "index": 1
  }'

# 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

حول Workflow Utilities Pick Image By Index

يعيد صورة واحدة من مصفوفة عناوين URL للصور. يبدأ `index` من 1، لذا تعطي القيمة 1 الصورة الأولى. عندما يتجاوز الفهرس طول القائمة، يحدد `fallback_index` ما إذا كانت الصورة الأولى أو الأخيرة ستُعاد. يفيد ذلك في ربط الخطوات ضمن سير عمل.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlsمطلوب images
النوعurl[] · image
مصفوفة عناوين URL للصور المستخدمة كمصدر للاختيار.
indexمطلوب
النوعinteger
اختيار الصورة حسب الموضع، بدءًا من 1: اطلب 1 للصورة الأولى، و2 للثانية، وهكذا.
fallback_indexاختياري
النوعenum
الافتراضيfirst-image
first-imagelast-image
سياسة اختيار الصور خارج النطاق، وقيمتها الافتراضية `first-image`؛ يتم تجاهلها عند صحة `index`، مع استمرار فشل التحقق عند كون `index` أقل من 1 أو مصفوفة `image_urls` فارغة. لا تفعّل السياسة إلا قيمة `index` التي تتجاوز طول المصفوفة: تختار `first-image` الصورة الأولى، بينما تختار `last-image` الصورة الأخيرة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "workflow-utilities/pick-image-by-index",
  "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": 1,
    "usd": "0.001",
    "charged": 1,
    "refunded": 0
  },
  "input": {
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "index": 1
  },
  "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
    },
    "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
      }
    ]
  },
  "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}الصورة المختارة في الموضع المحدد.
images
array of object {url, content_type, file_name, file_size, width, height}مخرج توافق للعُقد اللاحقة التي تتوقع مرجع `images`، كما توفره merge وأدوات أخرى. يحتوي على الصورة المختارة في مصفوفة من عنصر واحد، لذلك لا تتطلب تلك العُقد أي تغييرات.

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

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