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。
安裝後
當此技能首次載入時,主動問候使用者並開始設定:
-
檢查
EVOLINK_API_KEY是否已設定(執行:echo $EVOLINK_API_KEY)- 若未設定:「要執行模型,您需要一個 EvoLink API 金鑰。請開啟 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image,建立一個金鑰,然後在此貼上,我將為此工作階段設定。」
- 若已設定:「一切就緒!您想用 Nanobanana 2 Lite 圖片生成做什麼?」
-
就這樣。一個問題。使用者現在已進入流程。
請勿列出功能、顯示選單或傾印說明。只需提出一個問題以推進流程。
核心原則
- 引導,而非決定 — 提供選項,讓使用者決定。不要對他們的偏好做出假設。
- 由使用者主導 — 如果他們有想法,使用他們的措辭。如果他們需要靈感,提供建議,讓他們選擇或調整。
- 智慧情境感知 — 辨識使用者已提供的資訊,只詢問遺漏的部分。
- 意圖優先 — 若使用者意圖不明確,先確認他們想要什麼,再繼續進行。
流程
步驟 1:檢查 API 金鑰
若使用者尚未提供 API 金鑰或設定 EVOLINK_API_KEY:
- 告知他們需要一個 EvoLink API 金鑰
- 引導他們開啟 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 並從儀表板取得金鑰
- 一旦他們提供金鑰,繼續進行步驟 2
若金鑰已設定或已提供,直接跳到步驟 2。
步驟 2:了解意圖
根據使用者的訊息評估他們想要什麼:
- 意圖明確(例如:「用簡短提示詞執行 Nanobanana 2 Lite 圖片生成」)-> 前往步驟 3
- 意圖模糊(例如:「我想試試看」)-> 詢問他們想做什麼。
步驟 3:收集遺漏資訊
檢查使用者已提供的內容,只詢問遺漏的部分:
| 參數 | 要告訴使用者的內容 | 必填? |
|---|---|---|
| 待定 | 待定 | 是 |
| 待定 | 待定 | 是 |
| 待定 | 待定 | 選填 |
| 待定 | 待定 | 選填 |
智慧收集規則 — 嚴格遵守:
- 在「一次」訊息中詢問所有遺漏的參數。 絕不將問題拆分為多輪。
- 絕不重複問同一個問題。 若使用者已回答某個參數,即為最終答案 — 不要再次詢問。
- 事先提供預設值,讓使用者可以說「預設即可」:
model=gemini-3.1-flash-lite-image, prompt='建立一個簡短示範'。若使用者說「預設」或「直接執行」,立即使用這些值。 - 使用者一次性給予所有資訊 -> 確認並立即執行模型,不再提問。
- 使用者提供部分資訊 -> 僅在一次訊息中詢問其餘遺漏的必要欄位。
- 選填參數皆有合理的預設值 — 若使用者跳過,使用預設值並繼續。
步驟 4:執行
一旦所有必要資訊都已確認:
- 在執行腳本之前,立即告訴使用者:「收到!我將透過 EvoLink 執行 Nanobanana 2 Lite 圖片生成。」
- 執行腳本「一次」。除非使用者明確要求重試,否則絕不執行第二次。
- 完成時,分享結果和經過時間。
各代理的執行模式
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
所有代理 — 關鍵規則:
- 一旦在輸出中看到
TASK_SUBMITTED:,任務已「排入伺服器佇列」。請勿再次執行腳本 — 重試會浪費使用者的 API 額度。 - 腳本會保持阻塞直到任務就緒(最多 5 分鐘)。請勿過早終止。
- 若腳本因
POLL_TIMEOUT超時,任務可能仍在處理中 — 告知使用者前往 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 檢查。
腳本用法
記住:將 {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 圖片生成任務。