Bilder mit Auteo generieren
Verwendet die auteo CLI (npm i -g @auteo/cli, dann auteo auth login). Wenn ein Befehl mit Exit-Code 3 endet, folgen Sie dem Skill auteo-account, um sich zuerst anzumelden. MCP-Benutzer können dasselbe mit den unten aufgeführten auteo_*-Tools tun.
1. Ein Modell auswählen
auteo model list --type text_to_image --json # oder --type image_to_image für Bearbeitungen
auteo model get <model> --json # jeden Parameter, Optionen und Einschränkungen
Lesen Sie immer model get, bevor Sie generieren: Seitenverhältnisse und Auflösungsstufen variieren je nach Modell, und resolutionsByAspectRatio gibt an, welche Stufen jedes Verhältnis erlaubt.
Grober Leitfaden (prüfen Sie die aktuelle Liste, sie ändert sich):
| Bedarf | Gute erste Wahl |
|---|---|
| Beste Gesamtqualität, Text in Bildern | openai/gpt-image-2-6-sunburst, google/nano-banana-pro |
| Schnelle, günstige Entwürfe | google/nano-banana, alibaba/z-image |
| Bearbeiten eines Fotos mit Referenzbildern | google/nano-banana-2, bytedance/seedream-5-5 |
| Kostenlos für Plus / Ultra-Abonnenten | Modelle mit subscriberUnlimited: true (z. B. alibaba/z-image) |
2. Parameter wählen
--aspect-ratioist erforderlich. Verwenden Sie, was der Benutzer wünscht; andernfalls1:1für Avatare und Icons,16:9für Banner und Thumbnails,9:16für Stories,3:4für Porträts. Einige Modelle bieten auchauto.--resolutionist erforderlich, wenn das Modell Stufen hat (1K/2K/4K). Höhere Stufen kosten mehr. Standardmäßig1Kfür Entwürfe; nur höher gehen, wenn der Benutzer Druck oder große Anzeige wünscht, und sagen, dass es mehr kostet.--n(1–4) erstellt mehrere Variationen; jede wird berechnet.--image <pfad|https-url>(wiederholbar) fügt Referenzbilder zum Bearbeiten oder für den Stil hinzu. Lokale Dateien werden hochgeladen; die maximale Anzahl finden Sie inmodel get(inputAssetIds.max).- Schreiben Sie den Prompt auf Englisch, es sei denn, der Benutzer wünscht Text in einer anderen Sprache, der im Bild dargestellt werden soll.
3. Preis prüfen, dann generieren
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "a red fox in fresh snow, cinematic light" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <verz> wartet auf das Ergebnis und lädt die Dateien herunter; das JSON listet files und outputs[].url auf. Ohne --out/--wait gibt der Befehl sofort eine requestId zurück; rufen Sie diese später mit auteo generate wait <requestId> --out ./images ab.
Teilen Sie dem Benutzer die Dateipfade und die verbrauchten Credits (cost) mit.
Bei Fehlern
- Exit 4, nicht genügend Credits: Stoppen und dem Skill auteo-account folgen (dem Benutzer den Preis und Kontostand mitteilen, Link zum Aufladen). Keine Einstellungen eigenständig reduzieren.
- Exit 2, ungültige Parameter: Lesen Sie erneut
auteo model get <modell>und korrigieren Sie die Kombination aus Verhältnis / Stufe. - Exit 5, Prompt von Moderation abgelehnt: Prompt ohne beanstandeten Inhalt umschreiben; erneutes Senden des gleichen Prompts schlägt wieder fehl.
- Exit 6, Limit: Zu viele gleichzeitige Generierungen oder zu viele Einsendungen; warten und wiederholen.
- Zeitüberschreitung oder Netzwerkfehler während
create: Nicht blind erneut senden. Führen Sieauteo generate list --type image --limit 5 --jsonaus; wenn die Anfrage nicht vorhanden ist, mit--client-request-id <die zuvor gedruckte ID>wiederholen, damit sie nicht doppelt abgerechnet werden kann. status: failedim Ergebnis:errorMessagemelden; fallssuggestedModelgesetzt ist, dem Benutzer anbieten.
MCP-Tools
auteo_list_models, auteo_get_model, auteo_estimate_cost, auteo_upload_image (gibt eine assetId für inputAssetIds zurück), auteo_generate_image, auteo_get_generation (erneut nach pollAfterMs aufrufen, bis done), auteo_list_generations.