Communitygithub.com

Evolink-AI/nanobanana-2-lite-image-generate-api-skill

API-Endpunkt und installierbarer Agenten-Skill für Nanobanana 2 Lite Image Generation über EvoLink.

Was ist nanobanana-2-lite-image-generate-api-skill?

Dieser Skill ermöglicht es KI-Agenten (wie Claude Code, Cursor, Codex), Nanobanana 2 Lite Image Generation über den EvoLink-Dienst auszuführen. Er stellt einen installierbaren Skill mit einem vollständigen Workflow bereit: API-Schlüsselprüfung, Benutzerabsichtserfassung, Parametererhebung und Aufgabenausführung. Der Skill enthält ein Shell-Skript, das eine Bildgenerierungsaufgabe an die EvoLink-API sendet, den Status in regelmäßigen Abständen abfragt und das Ergebnis (Bild-URL) zusammen mit der Laufzeit zurückgibt. Er behandelt Fehler wie ungültige API-Schlüssel, unzureichendes Guthaben, Ratenbegrenzung und Dienstausfälle mit benutzerfreundlichen Meldungen. Der Skill soll den Bildgenerierungsprozess nahtlos in KI-gestützte Entwicklungsumgebungen integrieren, sodass Agenten Bilder generieren können, ohne die Schwierigkeiten der direkten API-Verwaltung.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add Evolink-AI/nanobanana-2-lite-image-generate-api-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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:

  1. Prüfe, ob EVOLINK_API_KEY gesetzt ist (Ausführen: echo $EVOLINK_API_KEY)

  2. 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

  1. Führen, nicht entscheiden – Präsentiere Optionen und lass den Benutzer entscheiden. Triff keine Annahmen über seine Vorlieben.
  2. 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.
  3. Intelligentes Kontextbewusstsein – Erkenne, was der Benutzer bereits bereitgestellt hat, und frage nur nach fehlenden Teilen.
  4. 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:

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:

ParameterWas dem Benutzer mitteilenErforderlich?
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:

  1. Teile dem Benutzer vor dem Ausführen des Skripts sofort mit: „Verstanden! Ich werde Nanobanana 2 Lite Image Generation über EvoLink ausführen.“
  2. 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.
  3. 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_TIMEOUT abbricht, 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:

ZeilenformatWannDeine Aktion
TASK_SUBMITTED: task_id=<id> estimated=<Ns>Direkt nach der EinreichungBestä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ührungAn den Benutzer weiterleiten – z. B. „Arbeite noch, etwa 30 Sekunden verbleibend …“
RESULT_URL=<Wert>Bei ErfolgExtrahieren und dem Benutzer präsentieren
ELAPSED=<Ns>Bei ErfolgOptional 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 FehlerDie 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:

FehlerWas 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-Referenz
  • scripts/nanobanana-2-lite-image.sh: Führe eine Nanobanana 2 Lite Image Generation-Aufgabe über EvoLink aus.

Verwandte Skills