דילוג לתוכן

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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 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 וכלי עזר אחרים. הוא מכיל את התמונה שנבחרה במערך בעל איבר אחד, ולכן צמתים אלה אינם דורשים שינויים.

מודלים נוספים: עריכת תמונה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/workflow-utilities/pick-image-by-index.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt