שפּרינגען צו אינהאַלט

Workflow Utilities Pick Image By Index

אינטעגרירן

מאָדעל־id 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Workflow Utilities Pick Image By Index

גיט צוריק איין בילד פֿון אַן אַרריי בילד־URLs. `index` איז 1-based, דערפֿאַר גיט 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` קלײַבט דאָס לעצטע.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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}קאָמפּאַטיביליטעט־רעזולטאַט פֿאַר downstream נאָודס וואָס דערוואַרטן אַן `images` רעפֿערענץ, ווי צוגעשטעלט דורך merge און אַנדערע יוטיליטיס. עס האלט דאָס אויסגעקליבענע בילד אין אַן עריי מיט איין עלעמענט, דערפֿאַר דאַרפֿן די נאָודס קיין ענדערונגען נישט.

מער מאָדעלן: בילד־עדיטירונג

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/workflow-utilities/pick-image-by-index.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt