Nanobanana 2 Lite Image Generation
Nanobanana 2 Lite Image Generation wird hier als EvoLink-API-Endpunkt mit einem passenden installierbaren Agenten-Skill bereitgestellt.
Wann dieser Skill aktiviert werden soll
Aktiviere diesen Skill, wenn der Benutzer Folgendes anfordert:
- Verwendung von Nanobanana 2 Lite Image Generation
- Ausführung von Nanobanana 2 Lite Image Generation über EvoLink
- Generierung einer Modellausgabe
- Testen des API-Ablaufs
Schlüsselwörter: nanobanana-2-lite-image-generation, evolink, api, agent, skill
Skript-Speicherort
WICHTIG: Alle Skript-Pfade in dieser Datei sind relativ zum Verzeichnis, das diese SKILL.md-Datei enthält. Bevor du ein Skript ausführst, löse den absoluten Pfad auf:
SKILL_DIR = Verzeichnis, das diese SKILL.md-Datei enthält
Skript = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh
Wenn sich diese SKILL.md zum Beispiel unter ~/.claude/skills/nanobanana-2-lite-image/SKILL.md befindet, dann ist das Skript unter ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh.
Nach der Installation
Wenn dieser Skill zum ersten Mal geladen wird, begrüße den Benutzer proaktiv und starte die Einrichtung:
-
Prüfe, ob
EVOLINK_API_KEYgesetzt ist (Ausführen:echo $EVOLINK_API_KEY)- Falls nicht gesetzt: „Um das Modell auszuführen, benötigst du einen EvoLink-API-Schlüssel. Öffne https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image, erstelle einen Schlüssel und füge ihn hier ein. Ich werde ihn für diese Sitzung setzen.“
- Falls bereits gesetzt: „Alles bereit! Was möchtest du mit Nanobanana 2 Lite Image Generation tun?“
-
Das war's. Eine Frage. Der Benutzer ist jetzt im Ablauf.
Liste keine Funktionen auf, zeige kein Menü und gebe keine Anweisungen aus. Stelle einfach eine Frage, um voranzukommen.
Kernprinzipien
- Führen, nicht entscheiden – Präsentiere Optionen und lass den Benutzer entscheiden. Triff keine Annahmen über seine Vorlieben.
- Den Benutzer steuern lassen – Wenn er eine Idee hat, verwende seine Worte. Wenn er Inspiration braucht, gib Vorschläge und lass ihn wählen oder verfeinern.
- Intelligentes Kontextbewusstsein – Erkenne, was der Benutzer bereits bereitgestellt hat, und frage nur nach fehlenden Teilen.
- Absicht zuerst – Wenn die Absicht des Benutzers unklar ist, bestätige, was er möchte, bevor du fortfährst.
Ablauf
Schritt 1: Prüfe auf API-Schlüssel
Wenn der Benutzer noch keinen API-Schlüssel bereitgestellt oder EVOLINK_API_KEY gesetzt hat:
- Teile ihm mit, dass er einen EvoLink-API-Schlüssel benötigt
- Leite ihn an, https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image zu öffnen und einen Schlüssel aus dem Dashboard zu holen
- Sobald er einen Schlüssel bereitstellt, fahre mit Schritt 2 fort
Wenn der Schlüssel bereits gesetzt oder bereitgestellt ist, überspringe direkt zu Schritt 2.
Schritt 2: Absicht verstehen
Bewerte, was der Benutzer basierend auf seiner Nachricht möchte:
- Absicht ist klar (z. B. „Führe Nanobanana 2 Lite Image Generation mit einem kurzen Prompt aus“) -> Gehe zu Schritt 3
- Absicht ist mehrdeutig (z. B. „Ich möchte es ausprobieren“) -> Frage, was er tun möchte.
Schritt 3: Fehlende Informationen sammeln
Prüfe, was der Benutzer bereits bereitgestellt hat, und frage nur nach dem, was fehlt:
| Parameter | Was dem Benutzer mitteilen | Erforderlich? |
|---|---|---|
| N.N. | N.N. | Ja |
| N.N. | N.N. | Ja |
| N.N. | N.N. | Optional |
| N.N. | N.N. | Optional |
Intelligente Sammelregeln – STRENG:
- Frage ALLE fehlenden Parameter in EINER einzigen Nachricht ab. Teile nie in mehrere Fragerunden auf.
- Stelle nie dieselbe Frage zweimal. Wenn der Benutzer einen Parameter bereits beantwortet hat, ist dieser endgültig – frage nicht erneut danach.
- Biete Standardwerte im Voraus an, damit der Benutzer „Standard ist in Ordnung“ sagen kann:
model=gemini-3.1-flash-lite-image, prompt='Erstelle eine kurze Demo'. Wenn der Benutzer „Standard“ oder „einfach los“ sagt, verwende diese Werte sofort. - Benutzer gibt alles auf einmal -> Bestätige und führe das Modell sofort aus, keine weiteren Fragen.
- Benutzer gibt Teilinformationen -> Frage nur nach den restlichen fehlenden Pflichtfeldern, alles in einer Nachricht.
- Optionale Parameter haben alle sinnvolle Standardwerte – wenn der Benutzer sie überspringt, verwende die Standardwerte und fahre fort.
Schritt 4: Ausführen
Sobald alle erforderlichen Informationen bestätigt sind:
- Teile dem Benutzer vor dem Ausführen des Skripts sofort mit: „Verstanden! Ich werde Nanobanana 2 Lite Image Generation über EvoLink ausführen.“
- Führe das Skript einmal aus. Führe es niemals ein zweites Mal aus, es sei denn, der Benutzer bittet explizit um einen erneuten Versuch.
- Wenn abgeschlossen, teile das Ergebnis und die vergangene Zeit mit.
Ausführungsmuster nach Agent
Claude Code – Verwende das Bash-Tool mit run_in_background: true, lies dann die Ausgabedatei, um den Fortschritt zu prüfen:
# Schritt 1: Im Hintergrund ausführen (löst zuerst SKILL_DIR auf)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"Eingabe\" --dry-run true", run_in_background: true, timeout: 300000)
# Schritt 2: ~30 Sekunden warten, dann die Ausgabedatei der Hintergrundaufgabe lesen, um nach RESULT_URL= oder STATUS_UPDATE-Zeilen zu suchen
# Schritt 3: Wenn du RESULT_URL=<Wert> siehst, leite es an den Benutzer weiter
OpenClaw / OpenCode / Cursor – Führe das Skript als blockierenden Shell-Befehl aus (das Skript behandelt sein eigenes Polling intern, dauert normalerweise 2-10 Minuten):
EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Eingabe" --dry-run true
Alle Agenten – kritische Regeln:
- Sobald du
TASK_SUBMITTED:in der Ausgabe siehst, ist die Aufgabe bereits auf dem Server in der Warteschlange. Führe das Skript NICHT erneut aus – ein erneuter Versuch verbraucht die API-Guthaben des Benutzers. - Das Skript blockiert, bis die Aufgabe bereit ist (bis zu 5 Minuten). Brich es nicht vorzeitig ab.
- Wenn das Skript mit
POLL_TIMEOUTabbricht, wird die Aufgabe möglicherweise noch verarbeitet – teile dem Benutzer mit, dass er unter https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image nachsehen soll.
Skriptverwendung
Denke daran: Ersetze {SKILL_DIR} durch das tatsächliche Verzeichnis, das diese SKILL.md-Datei enthält.
# API-Schlüssel setzen
export EVOLINK_API_KEY=dein_schluessel_hier
# Basis
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Erstelle eine kurze Nanobanana 2 Lite Image Generation Demo"
# Mit Optionen
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Test-Prompt" --dry-run true --timeout N.N.
# Erweitert
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Probelauf" --help N.N.
# Probelauf (Payload ohne API-Aufruf anzeigen)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Test" --dry-run
Skript-Ausgabeprotokoll
Das Skript schreibt strukturierte Zeilen nach stdout, die du parsen und darauf reagieren musst:
| Zeilenformat | Wann | Deine Aktion |
|---|---|---|
TASK_SUBMITTED: task_id=<id> estimated=<Ns> | Direkt nach der Einreichung | Bestätige dem Benutzer, dass die Aufgabe gestartet wurde. Dies bedeutet, dass der API-Aufruf erfolgreich war – wiederhole NICHT. |
STATUS_UPDATE: <Nachricht> | Alle ~15s während der Ausführung | An den Benutzer weiterleiten – z. B. „Arbeite noch, etwa 30 Sekunden verbleibend …“ |
RESULT_URL=<Wert> | Bei Erfolg | Extrahieren und dem Benutzer präsentieren |
ELAPSED=<Ns> | Bei Erfolg | Optional erwähnen, wie lange es gedauert hat |
POLL_TIMEOUT: task_id=<id> dashboard=<url> | Polling > 5 Min. | Dem Benutzer mitteilen: „Deine Aufgabe könnte bereits erledigt sein – überprüfe <dashboard_url> (Aufgabe: <id>)“ |
ERROR: … (stderr) | Bei Fehler | Die Fehlermeldung dem Benutzer anzeigen |
Kritisch: Sobald du TASK_SUBMITTED: siehst, ist die Aufgabe auf dem Server in der Warteschlange. Führe das Skript NICHT erneut aus. Ein erneuter Versuch verbraucht die API-Guthaben des Benutzers. Wenn das Skript lokal abbricht, wird die Aufgabe möglicherweise trotzdem abgeschlossen – teile dem Benutzer mit, dass er sein Dashboard unter https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image überprüfen soll.
Fehlerbehandlung
Gib freundliche, umsetzbare Meldungen aus:
| Fehler | Was dem Benutzer mitteilen |
|---|---|
| Ungültiger/fehlender Schlüssel (401) | „Dein API-Schlüssel scheint nicht zu funktionieren. Du kannst ihn unter https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image überprüfen“ |
| Unzureichendes Guthaben (402) | „Dein Kontoguthaben ist niedrig. Du kannst unter https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image Guthaben aufladen“ |
| Ratenbegrenzung (429) | „Zu viele Anfragen – lass uns einen Moment warten und es erneut versuchen“ |
| Inhalt blockiert (400) | „Diese Eingabe wurde von der Inhaltsmoderation markiert. Versuche, sie anzupassen“ |
| Dienst nicht verfügbar (503) | „Der Dienst ist vorübergehend ausgelastet. Versuchen wir es in einer Minute erneut“ |
Zusammenfassung der Modellfähigkeiten
Verwende dies, wenn der Benutzer fragt, was das Modell kann:
- API-Schnellstart: Erstelle eine Aufgabe, frage nach Abschluss und überprüfe die endgültige Antwort.
- Agenten-Skill: Verwende SKILL.md plus Skripte, um die Agentenausführung zu steuern.
- Fehlerbehebung: Verwende docs/errors.md und vollständige Beispiele, um häufige Fehler zu beheben.
- Release-Vorbereitung: Halte die Paketmetadaten vor der öffentlichen Veröffentlichung konsistent.
Referenzen
references/api-params.md: Vollständige API-Parameter-Referenzscripts/nanobanana-2-lite-image.sh: Führe eine Nanobanana 2 Lite Image Generation-Aufgabe über EvoLink aus.