README

由Servd创建

关于

不再为博客文章搜索库存图片，直接生成它们！

此Craft CMS插件向Craft添加了一个新的字段类型，其行为与正常的资产选择字段完全一样，但允许您使用Open AI DALL-E API生成图像，而不是上传图像。

定价

此插件的许可证费用为39美元，通过Craft插件商店购买。这仅适用于插件本身。使用Open AI API产生的额外费用不包括在内。您可以在此处了解更多关于Open AI DALL-E定价的信息。

入门

1. 通过命令行或插件商店将插件安装到您的Craft CMS 4+项目中
2. 此处创建Open AI API账户
3. 添加账单详情到您的Open AI API账户
4. 复制您的Open AI API密钥
5. 将您的API密钥添加到此插件的设置中
6. 将“带有DALL-E的资产”字段添加到您的Craft项目中

功能

• 在Craft控制面板中直接使用自定义提示生成DALL-E图像
• 设置常见的提示前缀和后缀，以保持特定资产字段的统一艺术风格
• 生成图像的“变体”，以提供几个类似选项
• 通过生成额外的边缘内容（可选地使用不同的提示！）将正方形的DALL-E图像转换为横幅
• 通过着色您想要更改的区域来重新绘制图像的特定区域
• 所选图像以常规图像资产的形式存储在Craft中

速率限制

Open AI API目前处于测试阶段，并实施了每60秒最多10个图像的速率限制。使用此插件很容易达到此限制。如果您达到限制，您将不会对失败的图像生成收费，并且您需要稍等片刻，直到它重置。

配置

插件设置

• Dall-E API密钥 - 用于与Open AI API通信的API密钥。我们建议将其设置为环境变量，以确保您的API密钥不会通过项目配置文件添加到项目存储库中。
• 生成次数 - 控制插件每次“操作”生成的图像数量。Open AI API按图像生成收费，因此这允许您在Craft中选择较少的选项的情况下降低总成本。

字段设置

除了所有标准资产字段设置之外，带有DALL-E的资产字段还具有以下附加设置

• 图像生成提示前缀 - 可选地指定将用于通过此字段创建的所有图像的提示前缀。这有助于定义一种常见的艺术风格。例如：“一个详细的铅笔草图”。

• 图像生成提示后缀 - 可选地指定将用于通过此字段创建的所有图像的提示后缀。这可以用于定义常见的提示修饰符。例如：“照片，广角，炮筒，f1.2，闪光灯打开”

使用字段

具有 DALL-E 字段功能的资产字段与普通资产字段完全一样，只是在现有的“添加资产”和“上传文件”按钮旁边，还有一个额外的按钮，上面标有“使用 DALL-E 生成图像”。

点击此按钮将启动一个模态窗口，在其中进行图像生成和选择。

生成新图像的第一步是在提示输入框中键入一个“提示”。提示定义了 DALL-E 将尝试生成的图像内容。如果您的字段有任何前缀或后缀定义，这些将在发送到 DALL-E API 之前添加到您的提示中。

添加您的提示后，点击“生成新图像”按钮创建您的图像！创建的图像数量由“生成计数”插件设置确定。

如果您看到自己喜欢的图像，下一步是“选择”它。通过悬停在图像上并点击按钮来实现。这将带您进入图像详情页面。

将鼠标悬停在左侧选定的图像上以放大并查看近距离的图像。

如果您对图像整体上很满意，但想从几个不同版本中选择，请使用“生成变体”按钮创建与当前选定图像相似的更多图像。如果您更喜欢新变体，只需“选择”它。

如果图像有微小的缺陷，或者您想使用图像的一部分但将其改变为其他内容，请使用“局部重绘”按钮。这允许您绘制出您想要重新生成的区域，同时保持图像中的其余部分完全不变。

一旦找到满意的图像，您就可以点击左侧的“使用此图像”按钮来保存您的图像并将其转换为 Craft 资产。所有 DALL-E 生成的图像都是正方形，因此此图像将保存为正方形。

如果您需要横向图像，只需点击“水平扩展”按钮。这将为您扩展图像的左右两侧生成选项。您可以选择左部和右部的任意组合来形成新的宽图像。一旦左右两侧都已选择，请点击“使用所选组合”按钮来保存您的图像并将其转换为 Craft 资产。

提示：在使用“水平扩展”或“局部重绘”功能之前，您可以在提示字段中更改提示文本，以更改添加到新生成部分的内容。

更新现有资产字段

我们已经测试了将普通资产字段转换为具有 DALL-E 的资产字段，没有遇到任何问题——这包括使用项目配置进行预演和生产部署。然而，如果您正在更改已广泛使用的字段，我们建议在升级您的生产环境之前执行完整的数据库备份。