Zuletzt aktualisiert: 13. April
# Node SDK Intents: CLI-Befehle für häufige Aufgaben
**Kevin van Zonneveld**
Mitgründer · Amsterdam, Niederlande · Bio anzeigen
[](https://x.com/kvz)[](https://github.com/kvz)
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](/de/docs/sdks/node-sdk.md) 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:
```bash
npx -y transloadit markdown pdf --input ~/code/uppy/README.md --print-urls
```
Sie erhalten eine Ausgabe wie diese:
```plaintext
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:
```bash
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:
```bash
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](https://github.com/transloadit/node-sdk/blob/main/packages/node/docs/intent-commands.md)oder in der [Dokumentation zum Node SDK](/de/docs/sdks/node-sdk.md).
## 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](/de/docs/sdks.md)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](/c/template-credentials/) als `TRANSLOADIT_KEY` und`TRANSLOADIT_SECRET` in `~/.transloadit/credentials`. Danach können Sie direkt loslegen:
```bash
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:
```bash
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](https://github.com/transloadit/node-sdk/issues), wenn eine Funktion fehlt oder die Bedienung noch komfortabler werden könnte.
[#node-js](/de/blog/tags/node-js.md)[#cli](/de/blog/tags/cli.md)[#integrations](/de/blog/tags/integrations.md)[#ai](/de/blog/tags/ai.md)
### 👩💻 Werden Sie Teil einer Community mit 20k+ Entwicklern
Abonnieren Sie unseren [monatlichen Newsletter EN (English)](/newsletters.md) und erhalten Sie direkte Links zu 3 exklusiven Tech-Beiträgen und 2 Produkt-Updates. Nicht mehr und nicht weniger.
Ihre E-Mail:
Zugang erhalten
## Datei-Uploads und Encoding leicht gemacht.
Transloadit vereinfacht das Dateihandling für Entwickler; Marken wie Coursera und The New York Times vertrauen auf die Plattform. Wir stehen für eine zuverlässige API, erstklassigen Support und ein starkes Engagement für Open Source; Projekte wie [Uppy](https://uppy.io) und [tus](https://tus.io) setzen Standards in der Dateiverarbeitung.
[Registrieren](/c/)[Demo buchen](https://survey.typeform.com/to/kRg47Xi5)
Keine Kreditkarte erforderlich · 5 GB im kostenlosen Tarif enthalten
Jederzeit kündbar