使用 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。