Zum Inhalt springen

Workflow Utilities Pick Image By Index

Integrieren

Modell-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"

Diese Anfrage: ≈0,001 $ 1 API-Credit Auf dieser Seite ausführen

API-Schlüssel abrufen
Utility · Bild

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich image_urls
Datei ablegen oder

Als Auswahlquelle verwendetes Bild-URL-Array.

•erforderlich

Bildauswahl nach Position, beginnend bei 1: 1 für das erste Bild, 2 für das zweite und entsprechend weiter anfordern.

Erweitert fallback_index
fallback_index Standard first-image

Richtlinie für die Bildauswahl außerhalb des gültigen Bereichs, standardmäßig `first-image`; bei einem gültigen `index` wird sie ignoriert, und die Validierung schlägt weiterhin für einen `index` unter 1 oder ein leeres `image_urls`-Array fehl. Nur ein `index` über der Array-Länge aktiviert die Richtlinie: `first-image` wählt das erste Bild, `last-image` das letzte Bild.

POST /run/workflow-utilities/pick-image-by-index?wait=20 Preis → 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"

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Workflow Utilities Pick Image By Index

Gibt ein Bild aus einem Array von Bild-URLs zurück. `index` ist 1-basiert, daher liefert 1 das erste Bild. Wenn der Index die Listenlänge überschreitet, bestimmt `fallback_index`, ob das erste oder letzte Bild zurückgegeben wird. Nützlich zum Verketten von Schritten in einem Workflow.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlserforderlich images
Typurl[] · image
Als Auswahlquelle verwendetes Bild-URL-Array.
indexerforderlich
Typinteger
Bildauswahl nach Position, beginnend bei 1: 1 für das erste Bild, 2 für das zweite und entsprechend weiter anfordern.
fallback_indexoptional
Typenum
Standardfirst-image
first-imagelast-image
Richtlinie für die Bildauswahl außerhalb des gültigen Bereichs, standardmäßig `first-image`; bei einem gültigen `index` wird sie ignoriert, und die Validierung schlägt weiterhin für einen `index` unter 1 oder ein leeres `image_urls`-Array fehl. Nur ein `index` über der Array-Länge aktiviert die Richtlinie: `first-image` wählt das erste Bild, `last-image` das letzte Bild.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
image
object {url, content_type, file_name, file_size, width, height}An der angegebenen Position ausgewähltes Bild.
images
array of object {url, content_type, file_name, file_size, width, height}Kompatibilitätsausgabe für nachgelagerte Knoten, die eine `images`-Referenz erwarten, wie sie von merge und anderen Hilfsfunktionen bereitgestellt wird. Sie enthält das ausgewählte Bild in einem Array mit einem Element, sodass diese Knoten nicht geändert werden müssen.

Weitere Modelle: Bildbearbeitung

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/workflow-utilities/pick-image-by-index.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt