Community影像github.com

auteo-generate-image

圖片技能。使用用戶的 Auteo(auteo.ai)帳戶生成或編輯圖片 — 支援 GPT Image、Nano Banana、Seedream、Z-Image 和 FLUX 等模型的文生圖與圖生圖。

auteo-generate-image 是什麼?

這個技能讓 AI 助手能透過 Auteo CLI 或 MCP 工具,利用用戶的 Auteo 帳戶來生成與編輯圖片。它整合了多種模型,包括 OpenAI 的 GPT Image、Google 的 Nano Banana、ByteDance 的 Seedream 與阿里巴巴的 Z-Image 等,適用於文生圖與圖生圖場景。用戶只需描述需求(如設計海報、縮圖、頭像或編輯照片),助手便會自動選擇合適模型、設定參數(如長寬比、解析度)並生成圖片。技能會處理定價確認、錯誤處理(如餘額不足、提示詞被拒)與重試邏輯,確保流程順暢。支援平台包括 CLI(npm 套件)與 MCP 工具,適合各類開發與設計工作流程。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/AuteoAI/skills/tree/HEAD/skills/auteo-generate-image

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

使用 Auteo 生成圖片

使用 auteo CLI(npm i -g @auteo/cli,然後執行 auteo auth login)。若指令以代碼 3 退出,請先依照 auteo-account 技能登入。MCP 用戶可使用文末所列的 auteo_* 工具完成相同操作。

1. 選擇模型

auteo model list --type text_to_image --json     # 或使用 --type image_to_image 進行編輯
auteo model get <model> --json                   # 取得所有參數、選項與限制

生成前務必讀取 model get:長寬比與解析度層級因模型而異,resolutionsByAspectRatio 會顯示每個比例允許哪些層級。

粗略指引(請查閱即時清單,內容可能變動):

需求首選模型
最佳整體品質,圖片中包含文字openai/gpt-image-2-6-sunburst、google/nano-banana-pro
快速、便宜草稿google/nano-banana、alibaba/z-image
使用參考圖片編輯照片google/nano-banana-2、bytedance/seedream-5-5
Plus / Ultra 訂閱者免費使用帶有 subscriberUnlimited: true 的模型(例如 alibaba/z-image)

2. 選擇參數

  • --aspect-ratio 為必要參數。使用用戶要求的比例;否則頭像與圖示用 1:1、橫幅與縮圖用 16:9、限時動態用 9:16、肖像用 3:4。部分模型也支援 auto。
  • --resolution 在模型有分層級(1K / 2K / 4K)時為必要參數。較高層級費用更高。草稿預設使用 1K;僅在用戶需要印刷或大螢幕顯示時才調高,並告知費用較高。
  • --n(1–4)可生成多個變體;每個變體均獨立計費。
  • --image <路徑|https-url>(可重複)添加參考圖片用於編輯或風格參考。本地檔案會上傳;允許的數量可在 model get 的 inputAssetIds.max 中查看。
  • 除非用戶希望圖片中呈現其他語言的文字,否則提示詞請使用英文撰寫。

3. 檢查價格,然後生成

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 <目錄> 會等待結果並下載檔案;JSON 會列出 files 與 outputs[].url。不加 --out/--wait 則指令會立即回傳 requestId;稍後可使用 auteo generate wait <requestId> --out ./images 取得結果。

告知用戶檔案路徑與花費的點數(cost)。

發生錯誤時

  • 退出代碼 4,點數不足:停止並依照 auteo-account 技能處理(告知用戶價格與餘額,提供儲值連結)。請不要自行降低設定。
  • 退出代碼 2,參數無效:重新讀取 auteo model get <model> 並修正比例 / 層級組合。
  • 退出代碼 5,提示詞被審核拒絕:重寫提示詞,移除被標記的內容;重新送出相同的提示詞仍會失敗。
  • 退出代碼 6,限制:太多進行中的生成或太多提交;請等待後重試。
  • create 期間超時或網路錯誤:不要盲目重新提交。執行 auteo generate list --type image --limit 5 --json;如果請求不在列表中,使用 --client-request-id <之前印出的 ID> 重試,以免重複計費。
  • 結果中出現 status: failed:回報 errorMessage;若設有 suggestedModel,則向用戶推薦該模型。

MCP 工具

auteo_list_models、auteo_get_model、auteo_estimate_cost、auteo_upload_image(回傳一個用於 inputAssetIds 的 assetId)、auteo_generate_image、auteo_get_generation(在 pollAfterMs 後再次呼叫,直到 done)、auteo_list_generations。

相關技能