Node SDK Intents: CLI-Befehle für häufige Aufgaben
Unser Node SDK enthält jetzt Intent-Befehle: CLI-Befehle mit höherem Abstraktionsgrad 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 folgenden Beispiele verwenden den aktuellen Paketnamen @transloadit/node.
Das CLI-Programm heißt weiterhin transloadit; das ältere npm-Paket
transloadit bleibt als Kompatibilitätsalias erhalten.
Hinweise zur Installation und Authentifizierung finden Sie in der
Dokumentation zum Node SDK.
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.
Ich habe Transloadit mitgegründet und stellte in meinem eigenen Arbeitsalltag 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 Abstraktionsschicht ü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 als 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/node markdown pdf --input ./README.md --print-urls
Sie erhalten eine Tabelle wie diese, mit Ihrer tatsächlichen temporären Ergebnis-URL in der letzten Spalte:
STEP NAME URL
convert README.pdf https://example.com/README.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 Befehle mit höherem Abstraktionsgrad statt JSON verwenden
Intents decken häufige Workflows mit kurzen, vorhersehbaren Befehlsnamen ab. Einige Beispiele:
npx -y @transloadit/node image remove-background --input ./photo.jpg --print-urls
npx -y @transloadit/node image generate --prompt "A red bicycle in a studio" --output bicycle.png
npx -y @transloadit/node image describe --input ./hero.jpg --for wordpress --output fields.json
npx -y @transloadit/node markdown docx --input ./plan.md --output plan.docx
Oder wie wäre es mit einer eingabegestützten Bilderzeugung:
npx -y @transloadit/node 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 versuchen, sinnvolle Standardeinstellungen zu wählen. Zum Zeitpunkt dieser Aktualisierung
verwendet image generate standardmäßig google/nano-banana-2;
mit --model können Sie explizit eine unterstützte Alternative auswählen.
Führen Sie npx -y @transloadit/node image generate --help aus, um die Optionen des installierten Befehls anzuzeigen,
statt diesen Artikel als dauerhaften Modellkatalog zu betrachten.
Die Standardmodelle können sich zwischen Releases ändern. Für eine reproduzierbare Integration fixieren Sie die SDK-Version in den Abhängigkeiten Ihres Projekts und wählen Sie bewusst ein Modell. Prüfen Sie anschließend dessen Ausgabe für Ihren Anwendungsfall.
Für einen vorhersehbaren Speicherort der Ausgabe geben Sie --output an.
Wenn Sie die Option weglassen, leitet die CLI einen Pfad aus dem Befehl und seinen Eingaben ab;
die Referenz zu Intent-Befehlen dokumentiert die Details. Verwenden Sie --print-urls
allein, wenn Sie temporäre Ergebnis-URLs erhalten möchten, ohne die Dateien lokal herunterzuladen.
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. Diese Instructions 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/node assemblies create. So können Sie jederzeit dazu übergehen, Ihre eigenen Medienpipelines zu erstellen.
Jetzt ausprobieren
Für die interaktive Nutzung beginnen Sie mit npx -y @transloadit/node auth login und folgen der
Einrichtungsanleitung für das Node SDK. Für die Automatisierung
verwenden Sie einen separaten Auth Key mit passenden Scopes und ein separates Auth Secret,
die Sie über Ihren Secret-Manager als TRANSLOADIT_KEY und
TRANSLOADIT_SECRET bereitstellen. Befolgen Sie dabei die Deployment-Hinweise des SDKs.
Diese API-Zugangsdaten authentifizieren Anfragen an Transloadit; sie sind nicht die
Template-Zugangsdaten, mit denen Sie auf einen Speicheranbieter zugreifen. Nehmen Sie das
Auth Secret weder in Browsercode noch in die Versionsverwaltung auf. Zeigen Sie anschließend
die verfügbaren Befehle an:
npx -y @transloadit/node --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.
