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 密钥加密存储。