Node SDK Intents: CLI-Befehle für häufige Aufgaben
Unser Node SDK enthält jetzt Intent-Befehle: übergeordnete CLI-Befehle für schnelle, häufige Transloadit-Jobs.
Unser Node SDK enthält jetzt Intent-Befehle: übergeordnete CLI-Befehle für häufige Transloadit-Aufgaben. Mit diesen Befehlen können Sie Transloadit wesentlich einfacher für einmalige Jobs nutzen, ohne zuerst JSON für Assembly Instructions von Hand zu schreiben.
Die Idee, unser Node SDK um praktische Befehlszeilenfunktionen zu ergänzen, entstand aus einem konkreten Problem auf unserer Seite. Wenn wir dauerhafte Integrationen entwickeln, sind JSON-Instructions und wiederverwendbare Templates genau die richtige Abstraktion. Sie sind ausdrucksstark, stabil und eignen sich gut für individuelle Workflows mit mehreren Steps. Für schnelle Befehlszeilen-Jobs können sie jedoch wie unnötiger Aufwand wirken.
In meinem eigenen Arbeitsalltag als Mitgründer stellte ich fest, dass ich Transloadit nicht nutzte, wenn ich schnell eine Markdown-Datei in eine PDF-Datei konvertieren wollte, obwohl wir genau dafür einen äußerst leistungsfähigen Service anbieten.
Also begann ich mich zu fragen, was eine Integration können müsste, damit ich sie nutzen würde. Ich notierte die Befehle, die ich verwenden wollte, und leitete daraus schrittweise eine Implementierung ab. Wir nennen sie: Intents.
Intents stehen in der CLI unseres Node SDK als zusätzliche, komfortable Ebene über unseren grundlegenden Konzepten wie Robots, Assemblies und Builtin Templates bereit.
Während die CLI Ihnen bisher direkten Zugriff auf diese grundlegenden Konzepte bot, orientiert sich
die neue Intents-Ebene nicht an unseren internen Strukturen, sondern an Ihrem einmaligen Anwendungsfall – mit intuitiven Befehlen wie
markdown pdf, markdown docx, image remove-background, image generate und image describe.
Einmalige Jobs über die CLI ausführen
Wenn Ihre Zugangsdaten für TRANSLOADIT_KEY und TRANSLOADIT_SECRET in der Shell, in einer
lokalen .env oder in ~/.transloadit/credentials verfügbar sind, können Sie jetzt Folgendes ausführen:
npx -y transloadit markdown pdf --input ~/code/uppy/README.md --print-urls
Sie erhalten eine Ausgabe wie diese:
STEP NAME URL
convert README.pdf https://pub-9974528f53db4a839e95f7e6ce9adb68.r2.dev/836b8ecaed114779b02cb99d4540d81f/37053087fe38475ea3fba78d87dbdfd3/9af5485747b446c5ab737b64db23afc4.pdf
Das bedeutet, dass Sie Transloadit als praktisches CLI-Tool für schnelle Jobs nutzen können und nicht ausschließlich als eingebettete Backend-Integration.
Für häufige Aufgaben übergeordnete Befehle statt JSON verwenden
Intents decken häufige Workflows mit kurzen, vorhersehbaren Befehlsnamen ab. Einige Beispiele:
npx -y transloadit image remove-background --input ./photo.jpg --print-urls
npx -y transloadit image generate --prompt "A red bicycle in a studio" --output bicycle.png
npx -y transloadit image describe --input ./hero.jpg --for wordpress --output fields.json
npx -y transloadit markdown docx --input ./plan.md --output plan.docx
Oder wie wäre es mit einer eingabegestützten Bilderzeugung:
npx -y transloadit image generate \
--input ./person1.jpg \
--input ./person2.jpg \
--input ./background.jpg \
--prompt "Place person1.jpg feeding person2.jpg in front of background.jpg" \
--output scene.png
Die vollständige Referenz finden Sie in der Referenz zu Intent-Befehlen auf GitHub oder in der Dokumentation zum Node SDK.
Benutzerfreundlichkeit als wichtigstes Designprinzip
Intents setzen auf leistungsfähige Standardeinstellungen. Derzeit verwendet image generate weiterhin standardmäßig
google/nano-banana-2. Das am 21. April 2026 angekündigte gpt-image-2 von OpenAI wird bereits
über --model openai/gpt-image-2 unterstützt. Es bleibt jedoch vorerst optional, bis es sich einige Wochen in der Praxis
bewährt hat und Benutzer Zeit hatten, herauszufinden, ob andere Prompts damit bessere Ergebnisse erzielen.
Der aktuelle Stand der Technik bei Bildmodellen entwickelt sich zu schnell, als dass wir Sie über jede tägliche Änderung informieren könnten. Sie können stattdessen von uns erwarten, dass wir die Standardeinstellung auf die allgemein beste Wahl für unsere Benutzer aktualisieren, sobald sich ein Modell tatsächlich in der Praxis bewährt hat.
Wie erwähnt, liegt der Schwerpunkt klar auf Benutzerfreundlichkeit. Wenn Sie --output weglassen, unternimmt die CLI
einiges, um einen sinnvollen Speicherort für die Ausgabedatei zu bestimmen, oder gibt einen Fehler aus. Bei
einer einzelnen Eingabedatei wählt sie deren Verzeichnis. Bei mehreren Eingabedateien wählt sie das
aktuelle Arbeitsverzeichnis. Bei einem Verzeichnisvorgang mit vielen Dateien geht sie
vorsichtiger vor und macht --output obligatorisch. Es sei denn, Sie bevorzugen eine URL zu einem temporären
Speicherort. In diesem Fall können Sie --print-urls angeben.
Zur besseren Lesbarkeit verwende ich in diesem Beitrag die Langform --output, selbstverständlich gibt es aber auch kurze Aliasse
wie -o.
Intents für schnelle Jobs und JSON für individuelle Workflows verwenden
Intents ersetzen nicht das grundlegende Modell von Transloadit. JSON-Instructions bleiben langfristig die richtige Abstraktion für integrierte Medienpipelines. Damit können Sie Abläufe erstellen, die auf Ihren Anwendungsfall zugeschnitten sind. Sie sind dafür vorgesehen, als Templates gespeichert und in der Produktion über unsere SDKs vielfach wiederverwendet zu werden.
Wenn Sie jedoch ein Befehlszeilenprofi sind oder vielleicht Ihr Agent einer ist und kurzfristig einige Medien verarbeiten müssen, könnte dies genau das Richtige sein.
Und denken Sie daran: Selbst wenn Ihre CLI-Anforderungen über Intents hinauswachsen, unterstützt unsere CLI weiterhin
npx -y transloadit assemblies create. So können Sie jederzeit dazu übergehen, Ihre eigenen Medienpipelines zu erstellen.
Jetzt ausprobieren
Wenn Sie bereits ein Transloadit-Konto haben, kopieren Sie
die Zugangsdaten für Ihren Workspace als TRANSLOADIT_KEY und
TRANSLOADIT_SECRET in ~/.transloadit/credentials. Danach können Sie direkt loslegen:
npx -y transloadit --help
Wenn Sie Ihrem Agenten (Cursor, Codex, Claude Code usw.) optional dabei helfen möchten, diese Intents zu finden und ihm leistungsstarke Funktionen zur Medienverarbeitung bereitzustellen, können Sie unsere Skills global installieren mit:
npx -y skills add https://github.com/transloadit/skills -g --all --copy
Ich hoffe, dass Sie damit Mediendateien wesentlich einfacher erstellen und verwalten können. Bitte teilen Sie mir im Issue-Tracker auf GitHub mit, wenn eine Funktion fehlt oder die Bedienung noch komfortabler werden könnte.