Agile Developer Hilfe-Center › Agile Render

Bulk aus einer Tabelle

Mit Bulk erzeugen Sie aus einer Tabelle viele Videos oder Bilder auf einmal: Jede Zeile wird ein Render, jede Spalte füllt ein Feld der Vorlage.

Typische Beispiele sind Stellenanzeigen für mehrere Standorte, Produktvideos für einen ganzen Katalog oder personalisierte Grüße für eine Kundenliste.

Vorbereitung

  • Die Vorlage braucht benannte, dynamische Felder, etwa „Titel“, „Foto“ und „Preis“. Siehe Artikel „Dynamische Felder“.
  • Veröffentlichen Sie die Vorlage. Bulk-Läufe nutzen die veröffentlichte Fassung.
  • Die erste Zeile der Tabelle enthält die Spaltennamen. Heißen die Spalten wie die Felder der Vorlage, werden sie automatisch zugeordnet.
  • Bilder, Videos und Audio geben Sie als öffentliche https-Adresse oder als Asset-ID aus Ihrer Medienbibliothek an.

Eine Tabelle kann zum Beispiel so aussehen:

Titel;Foto;Preis
Sneaker Aurora;https://ihre-firma.de/bilder/aurora.jpg;129 €
Sneaker Borealis;https://ihre-firma.de/bilder/borealis.jpg;149 €

Bulk-Lauf starten

  1. Öffnen Sie in der Seitenleiste Bulk und klicken Sie auf Neuer Bulk-Lauf. Aus dem Editor geht es auch über Verwenden › Tabelle (Bulk) › Bulk-Lauf starten.
  2. Vorlage: Wählen Sie die Vorlage.
  3. Daten: Wählen Sie eine Datenquelle:
  4. CSV hochladen: Datei hierher ziehen oder auswählen. Komma, Semikolon und Tab werden automatisch erkannt (.csv, .tsv, .txt).
  5. Einfügen: Zellen samt Überschriften in Excel, Numbers oder Google Sheets markieren, kopieren und einfügen.
  6. Tabelle: Zeilen direkt im Browser eingeben oder nachbearbeiten (In der Tabelle bearbeiten).
  7. Zuordnung: Ordnen Sie jeder Spalte ein Feld zu. Automatisch zuordnen übernimmt gleichnamige Spalten. Mindestens eine Spalte muss zugeordnet sein; nicht verwendete Spalten werden angezeigt.
  8. Vorschau: Sie sehen die ersten Zeilen als Live-Vorschau. Wählen Sie das Ausgabeformat (MP4, GIF, PNG, JPG) und den Namen des Laufs. Die geschätzten Credits werden angezeigt.
  9. Start: Prüfen Sie die Zusammenfassung und starten Sie den Lauf.

Sie können die Seite nach dem Start schließen. Sobald der Lauf fertig ist, bekommen Sie eine Push-Benachrichtigung, wenn Sie diese unter Einstellungen › Benachrichtigungen eingeschaltet haben.

Excel-Dateien (XLSX) lesen wir nicht direkt ein. Speichern Sie die Tabelle als CSV oder kopieren Sie die Zellen und nutzen Sie Einfügen.

Leere Zellen

Ist eine Zelle leer, bleibt für dieses Feld der Wert aus der Vorlage stehen. So können Sie zum Beispiel nur bei einigen Zeilen ein eigenes Foto angeben.

Ergebnisse herunterladen

Unter Bulk sehen Sie alle Läufe mit Status (Entwurf, Läuft, Fertig, Mit Fehlern, Abgebrochen). In einem Lauf zeigt jede Zeile ihren Status: Fertig, Fehlgeschlagen, In der Warteschlange oder Nicht gerendert. Ein Klick auf eine Zeile öffnet den Render.

  • ZIP herunterladen: alle fertigen Dateien in einer ZIP-Datei. Die Dateinamen beginnen mit der Zeilennummer, damit Sie sie Ihrer Tabelle zuordnen können.
  • CSV mit Links: die Tabelle mit den Datei-Adressen der Renders, etwa zum Weiterverarbeiten in Excel.
  • … fehlgeschlagene wiederholen: startet die fehlgeschlagenen Zeilen erneut.
  • Abbrechen: stoppt wartende Renders. Sie kosten nichts, fertige Dateien bleiben erhalten.

Die Dateien bleiben so lange abrufbar, wie Ihr Tarif Renders aufbewahrt.

Credits und Grenzen

  • Jede Zeile kostet so viele Credits wie ein einzelner Render, siehe Artikel „Credits und Tarife“.
  • Reicht das Guthaben voraussichtlich nicht, warnt der Assistent. Mit eingeschalteter automatischer Überschreitung rendern wir bis zu Ihrem Kostendeckel weiter. Sonst lehnt Agile Render den Start ab und der Lauf bleibt als Entwurf erhalten. Bei sehr großen Läufen werden die Credits in Blöcken zu 500 Zeilen geprüft; reicht das Guthaben für einen späteren Block nicht mehr, werden dessen Zeilen als fehlgeschlagen markiert.
  • Je Lauf sind bis zu 10.000 Zeilen möglich, eine CSV-Datei darf bis zu 10 MB groß sein.
  • Wie viele Renders gleichzeitig laufen, hängt vom Tarif ab. Weitere Zeilen warten in der Warteschlange.

Bulk per API

Bulk-Läufe lassen sich auch per API anlegen:

curl -X POST https://render.agiledeveloper.de/api/v1/bulk \
  -H "Authorization: Bearer agile_render_IhrSchluessel" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "IHRE-VORLAGEN-ID",
    "name": "Herbstkatalog",
    "zeilen": [
      { "Titel": "Sneaker Aurora", "Preis": "129 €" },
      { "Titel": "Sneaker Borealis", "Preis": "149 €" }
    ]
  }'

Statt zeilen können Sie mit csv den Inhalt einer CSV-Datei als Text senden. Die Antwort enthält die vorgeschlagene Zuordnung. Danach starten Sie den Lauf mit POST /api/v1/bulk/{id}/starten (optional mit zuordnung und optionen, etwa {"output_format": "mp4"}), verfolgen ihn mit GET /api/v1/bulk/{id} und laden die Dateien mit GET /api/v1/bulk/{id}/zip. Am Ende sendet Agile Render das Webhook-Ereignis bulk.completed.

Für einzelne Varianten aus Ihrem eigenen System ist oft auch POST /v1/renders mit einem Array von Modifications praktisch (bis zu 100 je Aufruf), siehe Artikel „API-Schlüssel und erste API-Anfrage“.

Fragen? Support-Chat in der App unter Hilfe oder info@agiledeveloper.de.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 19. Oktober 2026

Weitere Artikel zu Agile Render

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.