Eine Aufgabe auf viele Dateien anwenden
Diese Funktion wendet eine einzelne Aufgabe auf viele Elemente gleichzeitig an – etwa hundert Bilder verkleinern oder tausend Datensätze umwandeln – in einem einzigen Aufruf, statt dieselbe Aufgabe für jedes Element einzeln auszulösen. Das Ergebnis jedes Elements liegt gesammelt in einer einzigen Antwort vor.
Eine Aufgabe, viele Elemente
Statt für jede einzelne Datei einer Liste einen eigenen Aufruf zu starten, übergeben Sie die gesamte Liste auf einmal: Flow.batch wendet dieselbe Aufgabe auf jedes einzelne Element an und liefert alle Ergebnisse gesammelt zurück. Das eignet sich für alles, was sich wiederholt und in gleicher Form auf viele Elemente anwenden lässt, etwa das Verkleinern einer ganzen Bildersammlung oder das Umwandeln vieler Dokumente in ein einheitliches Format.
Kein Aufpreis pro Element
Die Funktion berechnet $0.002 pro Anfrage, unabhängig davon, ob die Liste ein einzelnes Element oder tausend Elemente enthält. Wer wiederholt große Listen verarbeitet, zahlt damit für den Stapel als Ganzes, nicht für jedes einzelne Element zusätzlich – ein Unterschied, der sich bei sehr vielen Elementen deutlich bemerkbar macht. Bei sehr großen Stapeln mit tausenden Elementen zahlt sich dieser Unterschied gegenüber Einzelaufrufen besonders deutlich aus.
Grenzen
Jedes Element im Stapel durchläuft dieselbe zugrunde liegende Funktion, deren eigene Grenzen weiterhin gelten – etwa die maximale Dateigröße einer einzelnen Bildbearbeitung. Für die Anzahl der Elemente pro Stapel ist aktuell kein gesondertes Höchstlimit veröffentlicht; bei sehr großen Listen empfiehlt sich ein Test mit einer kleineren Teilmenge vorab. Innerhalb dieser Grenzen lässt sich ein Stapel beliebig oft wiederholt ausführen, etwa jede Nacht mit einer aktualisierten Liste.
Anwendungsfälle
Ganze Bildersammlung verkleinern
Ein Onlineshop verkleinert alle 300 Produktfotos einer neuen Kollektion in einem einzigen Aufruf, statt jedes Bild einzeln zu bearbeiten.
Viele Belege gleichzeitig auswerten
Ein Steuerbüro lässt alle Belege eines Monats in einem Stapel auswerten, statt jeden einzeln zu öffnen.
Massenversand aus einer Liste
Weber Metallbau GmbH versendet dieselbe Zahlungserinnerung an alle säumigen Kundinnen und Kunden einer Liste in einem einzigen Aufruf.
Häufige Fragen
Kostet die Verarbeitung von tausend Elementen mehr als von einem?
Nein, $0.002 pro Anfrage gilt für den gesamten Stapel, unabhängig von der Anzahl der Elemente.
Gibt es ein Limit für die Anzahl der Elemente?
Aktuell ist kein gesondertes Höchstlimit veröffentlicht; bei sehr großen Listen empfiehlt sich vorab ein Test mit einer kleineren Teilmenge.
Was passiert, wenn ein einzelnes Element im Stapel fehlschlägt?
Die übrigen Elemente werden weiter verarbeitet; das Ergebnis zeigt, welches Element fehlgeschlagen ist.
Welche Aufgaben lassen sich als Stapel ausführen?
Grundsätzlich jede Funktion, die sich einzeln aufrufen lässt, sofern dieselbe Aufgabe unverändert auf jedes Element angewendet wird.
Werden die Elemente nach der Verarbeitung gespeichert?
Nein, sie dienen ausschließlich der Ausführung dieses einen Stapelaufrufs.
Kann ein fehlgeschlagenes Element automatisch erneut versucht werden?
Ja, in Kombination mit der Wiederholungsfunktion lässt sich ein einzelnes fehlgeschlagenes Element gezielt erneut ausführen.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/flow/batch \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/flow/batch", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/flow/batch",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/batch", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/batch", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"items": [
"valor-1",
"valor-2"
]
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "flow.batch",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |