Communitygithub.com

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

Nanobanana 2 Lite 圖片生成 API 範例及可安裝的 EvoLink 代理技能。

nanobanana-2-lite-image-generate-api-skill 是什麼?

此技能將 Nanobanana 2 Lite 圖片生成模型包裝為 EvoLink API 端點,並提供可安裝的代理技能,讓開發者與 AI 代理(如 Claude Code、Cursor、Codex)能直接在終端機中生成圖片。使用者無需手動處理 API 請求或輪詢。技能會引導設定 API 金鑰、收集必要參數(如提示詞),並以結構化腳本輸出回傳結果,包括任務提交、狀態更新與最終圖片 URL。透過一致的流程與錯誤處理,此技能簡化了圖片生成任務的整合與自動化。

相容平台✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add Evolink-AI/nanobanana-2-lite-image-generate-api-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Nanobanana 2 Lite 圖片生成

Nanobanana 2 Lite 圖片生成在此以 EvoLink API 端點的形式提供,並附帶可安裝的代理技能。

何時啟用此技能

當使用者要求以下事項時,啟用此技能:

  • 使用 Nanobanana 2 Lite 圖片生成
  • 透過 EvoLink 執行 Nanobanana 2 Lite 圖片生成
  • 產生模型輸出
  • 測試 API 流程

關鍵字:nanobanana-2-lite-image-generation、evolink、api、agent、skill

腳本位置

重要:此檔案中的所有腳本路徑均相對於包含此 SKILL.md 檔案的目錄。在執行任何腳本前,請解析出絕對路徑:

SKILL_DIR = 包含此 SKILL.md 檔案的目錄
Script = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh

例如,若此 SKILL.md 位於 ~/.claude/skills/nanobanana-2-lite-image/SKILL.md,則腳本位於 ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh。

安裝後

當此技能首次載入時,主動問候使用者並開始設定:

  1. 檢查 EVOLINK_API_KEY 是否已設定(執行:echo $EVOLINK_API_KEY)

  2. 就這樣。一個問題。使用者現在已進入流程。

請勿列出功能、顯示選單或傾印說明。只需提出一個問題以推進流程。

核心原則

  1. 引導,而非決定 — 提供選項,讓使用者決定。不要對他們的偏好做出假設。
  2. 由使用者主導 — 如果他們有想法,使用他們的措辭。如果他們需要靈感,提供建議,讓他們選擇或調整。
  3. 智慧情境感知 — 辨識使用者已提供的資訊,只詢問遺漏的部分。
  4. 意圖優先 — 若使用者意圖不明確,先確認他們想要什麼,再繼續進行。

流程

步驟 1:檢查 API 金鑰

若使用者尚未提供 API 金鑰或設定 EVOLINK_API_KEY:

若金鑰已設定或已提供,直接跳到步驟 2。

步驟 2:了解意圖

根據使用者的訊息評估他們想要什麼:

  • 意圖明確(例如:「用簡短提示詞執行 Nanobanana 2 Lite 圖片生成」)-> 前往步驟 3
  • 意圖模糊(例如:「我想試試看」)-> 詢問他們想做什麼。

步驟 3:收集遺漏資訊

檢查使用者已提供的內容,只詢問遺漏的部分:

參數要告訴使用者的內容必填?
待定待定是
待定待定是
待定待定選填
待定待定選填

智慧收集規則 — 嚴格遵守:

  • 在「一次」訊息中詢問所有遺漏的參數。 絕不將問題拆分為多輪。
  • 絕不重複問同一個問題。 若使用者已回答某個參數,即為最終答案 — 不要再次詢問。
  • 事先提供預設值,讓使用者可以說「預設即可」:model=gemini-3.1-flash-lite-image, prompt='建立一個簡短示範'。若使用者說「預設」或「直接執行」,立即使用這些值。
  • 使用者一次性給予所有資訊 -> 確認並立即執行模型,不再提問。
  • 使用者提供部分資訊 -> 僅在一次訊息中詢問其餘遺漏的必要欄位。
  • 選填參數皆有合理的預設值 — 若使用者跳過,使用預設值並繼續。

步驟 4:執行

一旦所有必要資訊都已確認:

  1. 在執行腳本之前,立即告訴使用者:「收到!我將透過 EvoLink 執行 Nanobanana 2 Lite 圖片生成。」
  2. 執行腳本「一次」。除非使用者明確要求重試,否則絕不執行第二次。
  3. 完成時,分享結果和經過時間。

各代理的執行模式

Claude Code — 使用 Bash 工具搭配 run_in_background: true,然後讀取輸出檔案以檢查進度:

# 步驟 1:在背景執行(先解析 SKILL_DIR)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"input\" --dry-run true", run_in_background: true, timeout: 300000)

# 步驟 2:等待約 30 秒,然後讀取背景任務輸出檔案,檢查是否有 RESULT_URL= 或 STATUS_UPDATE 行

# 步驟 3:當看到 RESULT_URL=<值> 時,將其傳達給使用者

OpenClaw / OpenCode / Cursor — 以阻塞式 shell 命令執行腳本(腳本會內部處理輪詢,通常 2-10 分鐘內完成):

EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "input" --dry-run true

所有代理 — 關鍵規則:

腳本用法

記住:將 {SKILL_DIR} 替換為包含此 SKILL.md 檔案的實際目錄。

# 設定 API 金鑰
export EVOLINK_API_KEY=your_key_here

# 基本用法
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "建立一個簡短的 Nanobanana 2 Lite 圖片生成示範"

# 搭配選項
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "測試提示詞" --dry-run true --timeout 待定

# 進階用法
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "乾執行" --help 待定

# 乾執行(預覽請求內容,不呼叫 API)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "測試" --dry-run

腳本輸出協定

腳本會將結構化行寫入 stdout,您必須解析並據此行動:

行格式時機您的行動
TASK_SUBMITTED: task_id=<id> estimated=<Ns>提交後立即向使用者確認任務已啟動。 這表示 API 呼叫成功 — 請勿重試。
STATUS_UPDATE: <message>每約 15 秒執行期間傳達給使用者 — 例如,「仍在處理,約剩 30 秒...」
RESULT_URL=<value>成功時提取並呈現給使用者
ELAPSED=<Ns>成功時可選擇提及耗時
POLL_TIMEOUT: task_id=<id> dashboard=<url>輪詢超過 5 分鐘告訴使用者:「您的任務可能已完成 — 請檢查 <dashboard_url>(任務:<id>)」
ERROR: ...(stderr)失敗時將錯誤訊息呈現給使用者

關鍵:一旦看到 TASK_SUBMITTED:,任務已排入伺服器佇列。請勿再次執行腳本。 重試會浪費使用者的 API 額度。若腳本在本地超時,任務仍可能完成 — 告知使用者前往 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 檢查儀表板。

錯誤處理

提供友善、可操作訊息:

錯誤要告訴使用者的內容
無效/缺少金鑰 (401)「您的 API 金鑰似乎無法使用。您可以在 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 檢查。」
餘額不足 (402)「您的帳戶餘額不足。您可以在 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 充值。」
請求過多 (429)「請求過多 — 讓我們稍等片刻再試。」
內容被封鎖 (400)「此輸入被內容審核標記。請嘗試調整。」
服務不可用 (503)「服務暫時忙碌。讓我們一分鐘後再試。」

模型能力摘要

當使用者詢問模型能做什麼時使用:

  • API 快速入門:建立任務、輪詢完成狀態、檢查最終回應。
  • 代理技能:使用 SKILL.md 加腳本引導代理執行。
  • 故障排除:使用 docs/errors.md 和完整範例除錯常見失敗。
  • 發布準備:在公開發布前保持套件後設資料一致。

參考資料

  • references/api-params.md:完整的 API 參數參考
  • scripts/nanobanana-2-lite-image.sh:透過 EvoLink 執行 Nanobanana 2 Lite 圖片生成任務。

相關技能