Image Generator
以 AI 為你的項目產生特色圖片,可逐個或批次產生。支援 OpenAI、OpenRouter 與 Cloudflare Workers AI。
外掛
Image Generator
以 AI 為你的項目產生特色圖片,可逐個或批次產生。支援 OpenAI、OpenRouter 與 Cloudflare Workers AI。
描述
以 AI 為你的項目產生特色圖片,可在後台的 Image Generator 頁面進行,也可在項目編輯器中進行。它支援 OpenAI、OpenRouter 與 Cloudflare Workers AI,並把圖片儲存到你的 EmDash 媒體庫。
單一項目。 在編輯器中開啟 Image Generator 面板,按下 Generate,檢視結果,然後選擇 Attach(附加)或 Regenerate(重新產生)。在後台頁面中,你還可以先編輯提示詞並選擇其他模型。
多個項目。 選擇一個集合,勾選需要圖片的項目,檢查並確認。圖片會在背景逐張產生,並顯示進度,支援 Stop 與 Resume。如果供應商拒絕金鑰、額度用完或達到每日上限,執行會自動停止。已經有圖片的項目絕不會被更動。
設計上確保可控
- 每張圖片都是向你的供應商發出的一次付費請求。每次呼叫之前都會強制檢查嚴格的每日上限(預設 20 張),呼叫失敗時會退還額度。
- 沒有點擊與確認,就不會產生任何內容。儲存時自動產生的功能存在,但預設關閉。
- 批次執行僅限編輯者與管理員使用。
- 如果某個集合使用草稿,圖片會進入草稿:需要發佈該項目,圖片才會上線。
你可以直接向供應商付費,或者,如果你願意,使用選用的 Sneaps license:這是一種按月提供一定數量圖片的訂閱,在外掛的 Licence 分頁中以授權金鑰啟用,無需設定供應商帳號。條款、退款與隱私權。
安裝
- 安裝外掛並核准其權限(列在「安全性」部分)。
- 確保你的主機具有
EMDASH_ENCRYPTION_KEY環境變數,以便加密儲存 API 金鑰。 - 開啟外掛的設定頁面。選擇供應商並輸入其 API key。對於 Cloudflare Workers AI,請使用具有 Workers AI 權限的權杖,並同時填寫你的帳號 ID。模型留空則使用預設模型。
- 在後台選單中開啟 Image Generator,進入 Collections 分頁,並為每個要使用的集合選擇圖片欄位。
- 選用:選擇一個風格預設,編輯提示詞範本(
、、、),並設定每日上限。
建議從 low 品質開始:不同供應商、模型與品質等級之間的價格差異很大。
Cloudflare 的第三方模型(例如 xai/grok-imagine-image-2.0)透過 Unified Billing 計費。它們需要在 AI Gateway 中有餘額,開啟 Authenticated Gateway,並使用具有 AI Gateway Run 權限的權杖。
常見問題
它會取代我既有的圖片嗎? 批次執行中絕不會。對於單一項目,只有在你按下 Attach 時,新圖片才會取代舊圖片。
為什麼提示請求逾時?
外掛每個請求只有 30 秒。在某些模型上,high 品質可能超過這個時間:請使用 low 或 medium。
「Rejected the API key」是什麼意思? 所選供應商只有一個 API 金鑰設定。切換供應商之後,請輸入該供應商的金鑰。當已儲存的金鑰看起來屬於另一個供應商時,訊息中會有提示。
「Daily limit reached」是什麼意思? 計數器在 UTC 00:00 重設。如果需要更多,請在設定中提高 Max generations per day。
Cloudflare FLUX.2 模型無法使用。
@cf/black-forest-labs/flux-2-* 模型目前尚不支援。請使用 @cf/black-forest-labs/flux-1-schnell,或第三方的 black-forest-labs/flux-2-max。
「Needs credits or a payment method」是什麼意思? Cloudflare 的第三方模型使用 Unified Billing:請在 AI Gateway 中儲值。
我在編輯器裡等待時沒有任何動靜。 使用 Sneaps license 時,產生需要 10 到 15 秒(其他供應商為 10 到 30 秒),而且編輯器不顯示載入動畫:它的 Block Kit 沒有載入狀態。對同一項目的第二次點擊會被拒絕,因此你不會被意外重複扣費。
什麼是 Sneaps license? 一種選用的訂閱:每月提供一定數量的圖片,無需供應商帳號。在 Licence 分頁中啟用你的授權金鑰,然後將其選為供應商。授權到期後,只有該供應商會停止運作。
圖片在哪裡? 在項目的圖片欄位中,以及媒體庫中。如果該集合使用草稿,請發佈該項目。
安全性
權限及其用途
- 讀取與寫入內容: 讀取標題與摘要,設定圖片欄位。
- 讀取與寫入媒體: 儲存產生的圖片,並刪除你捨棄的預覽。
- 讀取結構描述: 列出你的集合及其圖片欄位。
- 網路,僅限
api.openai.com、openrouter.ai、api.cloudflare.com與*.r2.cloudflarestorage.com:呼叫圖片供應商。最後一個主機僅用於下載 Cloudflare 第三方模型以簽署連結傳回的圖片,並且只從 AI Gateway 輸出儲存貯體下載。選用的 Sneaps license 會增加proxy.sneaps.io(服務)與api.polar.sh(授權伺服器),並且只有在你啟用授權或將其選為供應商時才會聯絡它們。
你的資料
提示詞(項目標題、摘要與你的風格文字)會傳送給你選擇的供應商。使用 Sneaps license 時,它們會連同你的授權金鑰傳送到該服務;授權伺服器會收到金鑰、產品名稱與你網站的主機名稱;該服務保留計數器與請求 ID,不保留提示詞或圖片。API 金鑰使用你的 EMDASH_ENCRYPTION_KEY 加密儲存,絕不會寫入記錄或產生歷程。歷程會保留集合、項目 ID、供應商、模型、狀態、媒體參照,以及失敗時的錯誤訊息:絕不包含提示詞、圖片或金鑰。
付費服務的隱私權政策:https://www.sneaps.io/legal/privacy/
回報漏洞: 請寫信至 [email protected](或使用 https://www.sneaps.io/contact)。
變更記錄
0.2.0
- 選用的 Sneaps license(按月提供圖片配額的訂閱,無需供應商帳號)作為第四個供應商,並新增 Licence 分頁,顯示授權與剩餘配額。
- 現在可在 EmDash 於 Cloudflare 上的沙箱模式下運作:每個頁面與動作都符合沙箱 10 次主機呼叫的上限。0.1.0 版本無法在那裡產生。
- 批次產生最多同時在背景產生四張圖片,項目清單新增 Select all 與 Select none。
- 儲存時自動產生現在是單一背景工作。
- 需要 EmDash 1.1.0 或更新版本。
- 授權改為專有。0.1.0 版本仍維持 MIT。
首次發布
- 一個 Image Generator 後台頁面,含三個分頁:Generate、Collections 與 Settings。
- 為單一項目產生圖片,提示詞可編輯並可預覽,可從編輯器面板或後台頁面進行。
- 為多個項目批次產生:選擇、確認、附進度的背景執行,支援 Stop 與 Resume。
- 供應商:OpenAI、OpenRouter、Cloudflare Workers AI 與 Cloudflare 第三方模型。
- 嚴格的每日上限、依項目加鎖、選用的儲存時自動產生。
- API 金鑰加密儲存。