1.1.1 Firefly Services快速入门

Firefly Services包括​ Firefly API、Lightroom API、Photoshop API、InDesign API ​和​ 内容标记API。

这些API包将Adobe的创作工具(如Photoshop和Lightroom)的强大功能与前沿的AI/ML功能（如内容标记、创成性填充、文本到图像等）结合起来。

使用Firefly Services，您不仅要创建，还要自动化、扩展内容生产，并利用最新的AI/ML技术来强化工作流程。

在本练习中，您将了解如何使用Postman和Adobe I/O来使用各种Adobe Firefly Services API。

本练习专门针对Firefly API，例如：

1.1.1.1先决条件

在继续此练习之前，您需要完成您的Adobe I/O项目的设置，还需要配置应用程序以与API交互，例如Postman或PostBuster。

1.1.1.2 API基础知识

有多种类型的API请求：

在使用API时，您还会注意到各个API端点返回的响应代码。

您可能会收到5种不同类型的响应：

以下是您可能会期望得到的常见响应代码示例：

1.1.1.3浏览firefly.adobe.com — 第1阶段

让我们开始探索Adobe Firefly Services。 对于探究，您首先会看到CitiSignal图像生成示例。 CitiSignal设计团队希望生成CitiSignal品牌名称的霓虹版本。 他们希望使用Adobe Firefly Services来做到这一点。

要实现这一点，首先需要的是CitiSignal品牌名称的黑白版本，它看起来像这样：

1.1.1.3.1创建合成参考图像

您可以使用此示例图像，也可以创建自己的文本进行试验。 请按照Adobe Illustrator中的以下步骤创建自己的图像文件。 如果您选择使用预定义的图像，请跳过以下部分并转到步骤​ 1.1.1.3。2直接生成图像。

打开​ Adobe Illustrator。 单击​ 新建文件。

选择​ Web-Large 1920 x 1080px。 单击​ 创建。

然后您应该拥有此项。 单击​ T ​文本图标。

然后您应该拥有此项。

将字体类型更改为所选字体，在此示例中字体类型为​ Adobe Clean Bold。

将字体大小更改为所选大小，在此示例中为​ 250 pt。

然后您应该拥有此项。

根据需要更改文本，在本例中为​ CitiSignal。

将文件中的文本居中对齐。

转到​ 文件>导出>保存以用于Web（旧版）

然后您应该拥有此项。 单击​ 保存。

为您的文件提供一个名称并将其保存到桌面。 单击​ 保存。

1.1.1.3.2生成图像

转到https://firefly.adobe.com。 单击​ 配置文件 ​图标，并确保您已登录到右侧的​ 帐户，它应为--aepImsOrgName--。 如果需要，请单击​ 切换配置文件 ​以切换到该帐户。

输入提示neon light lettering on a brick wall of a night club。 单击​ 生成。

然后，您应该有类似于此的内容。 这些图像还没有用处。 在​ 合成 ​下，单击​ 上传图像。

选择您之前创建的图像，在本例中为​ CitiSignal.jpg。 单击​ 打开，然后单击​ 生成。

然后，您应该有类似于此的内容。 合成参考的应用还不够好。 若要更改此值，请将​ 强度 ​滑块更改为最大值。 再次单击​ 生成。

现在，您有几张图像显示了CitiSignal品牌名称的纯新版本，您可以使用该版本进行进一步迭代。

现在，您已学会使用Firefly在几分钟内解决设计问题。

1.1.1.4浏览firefly.adobe.com — 第2阶段

转到https://firefly.adobe.com/generate/image。 您应该会看到此内容。 单击​ 模型 ​下拉列表。 您会注意到Adobe Firefly Services有3个可用版本：

单击以为此练习选择​ Firefly图像3。

输入提示Horses in a field并单击​ 生成。

然后，您应该会看到类似以下的内容。

接下来，在浏览器中打开​ 开发人员工具。

您应该会看到此内容。 转到​ 网络 ​选项卡。 然后，再次单击​ 生成。

输入搜索词​ generate-async。 然后，您应该会看到名称为​ generate-async ​的请求。 选择它，然后转到​ 有效负荷，您将在其中查看请求的详细信息。

您在此处看到的请求是发送到Firefly Services服务器端后端的请求。 它包含几个重要参数：

请再次查看UI。 将​ 宽高比 ​更改为​ 宽屏(16:9)。

向下滚动到​ 效果，转到​ 主题 ​并选择一种效果，如​ 装饰艺术效果。

确保仍在浏览器中打开​ 开发人员工具。 然后，单击​ 生成 ​并检查正在发送的网络请求。

现在，当您检查网络请求的详细信息时，将会看到以下内容：

在下一个练习中，您需要使用​ seed ​编号之一。 写下选择的种子号。

在下一个练习中，您将使用Firefly Services执行类似操作，但随后会使用API而不是UI。 在此示例中，第一个图像的种子号为​ 142194，该图像有2匹马头朝对方看着。

1.1.1.5 Adobe I/O - access_token

在​ Adobe IO - OAuth ​集合中，选择名为​ POST — 获取访问令牌 ​的请求，然后选择​ 发送。 响应应包含新的​ access_token。

1.1.1.6 Firefly Services API，文本2图像，图像3

现在您拥有了有效且新鲜的access_token，您可以向Firefly Services API发送您的第一个请求了。

您将在此处使用的请求是一个​ 异步 ​请求，该请求为您提供包含已提交作业的URL的响应，这意味着您将需要使用第二个请求来检查作业的状态并访问生成的图像。

从​ FF - Firefly Services Tech Insiders ​收藏集中选择名为​ POST - Firefly - T2I V3 async ​的请求。 转到​ 标头 ​并验证键/值对组合。

此请求中的这两个值都引用了预先定义的环境变量。 {{API_KEY}}引用您的Adobe I/O项目的字段​ 客户端ID。 在本教程的​ 快速入门 ​部分中，您已在Postman中进行配置。

字段​ Authorization ​的值是位特殊值： Bearer {{ACCESS_TOKEN}}。 它包含对您在上一步中生成的​ 访问令牌 ​的引用。 当您在​ Adobe IO - OAuth ​集合中使用请求​ POST - Get Access Token ​收到​ 访问令牌 ​时，Postman中运行了一个脚本，该脚本将字段​ access_token ​存储为环境变量，该变量现已在请求​ POST - Firefly - T2I V3异步 ​中引用。 请注意特定添加的​ Bearer ​一词和{{ACCESS_TOKEN}}之前的空格。 单词载体区分大小写，并且需要空格。 如果未正确执行此操作，Adobe I/O将返回​ 401 Unauthorized ​错误，因为它无法正确处理您的​ 访问令牌。

接下来，转到​ 正文 ​并验证提示。 单击​ 发送。

然后您会立即得到响应。 此响应不包含已生成图像的图像URL，而是包含您启动的作业的状态报告的URL，并且包含另一个允许您取消正在运行的作业的URL。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

您应该已经收到了类似的响应。 这是已执行的作业的概述。 您可以看到包含所生成图像的字段​ url。 从响应中复制（或单击）图像URL，然后在Web浏览器中打开该URL以查看图像。

您应该会看到一个美妙的图像，其中描绘了horses in a field。

在请求​ POST - Firefly - T2I V3异步 ​的​ Body ​中，在字段"promptBiasingLocaleCode": "en-US"下添加以下内容，并使用Firefly Services UI随机使用的种子编号之一替换变量XXX。 在此示例中，seed ​编号为142194。

,
  "seeds": [
    XXX
  ]

单击​ 发送。 然后，您将再次收到一个响应，其中包含指向您刚刚提交的作业的状态报告的链接。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

然后，您应该会看到基于已使用的​ 种子 ​而略有差异的新图像。 种子142194有2匹马相互注视，两匹马的头相互对视。

接下来，在请求​ POST - Firefly - T2I V3异步 ​的​ Body ​中，将以下​ 样式 ​对象粘贴到​ seed ​对象下。 这会将生成的图像的样式更改为​ art_deco。

,
  "contentClass": "art",
  "styles": {
    "presets": [
      "art_deco"
    ],
    "strength": 50
  }

然后您应该拥有此项。 单击​ 发送。 然后，您将再次收到一个响应，其中包含指向您刚刚提交的作业的状态报告的链接。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

您的图像现在发生了一些更改。 应用样式预设时，种子图像的应用方式不再与之前相同。 总的来说，使用生成型人工智能，很难保证输入参数的相同组合能够生成相同的图像。

从​ POST - Firefly - T2I V3异步 ​请求的​ Body ​中删除​ seed ​对象的代码。 单击​ 发送，然后单击从响应中获得的图像URL。 然后，您将再次收到一个响应，其中包含指向您刚刚提交的作业的状态报告的链接。

,
  "seeds": [
    XXX
  ]

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

您的图像现在又发生了一些更改。

1.1.1.7 Firefly Services API，一般扩展

从​ FF - Firefly Services Tech Insiders ​集合中选择名为​ POST - Firefly - Gen Expand异步 ​的请求，并转到该请求的​ 正文。

然后，您将再次收到一个响应，其中包含指向您刚刚提交的作业的状态报告的链接。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

您会看到在上一个练习中生成的图像现在已扩展到3999x3999的分辨率。

使用​ Firefly - T2I V3异步 ​请求生成新图像。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

然后，您应该会看到类似图像。

从​ FF - Firefly Services Tech Insiders ​集合中选择名为​ POST - Firefly - Gen Expand异步 ​的请求，并转到该请求的​ 正文。

当更改放置的对齐方式时，输出也将略有不同。 在此示例中，位置被更改为​ 左，底部。 单击​ 发送。 然后，您将再次收到一个响应，其中包含指向您刚刚提交的作业的状态报告的链接。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

然后您应该看到原始图像以不同的位置使用，这会影响整个图像。

1.1.1.8 Firefly Services API，文本2图像，图像4和图像4 Ultra

在最新版本的Firefly Image Model 4中，提供了几项改进：

Firefly Image Model 4为您提供卓越的人类、动物和详细场景图像，您可以使用Image Model 4 Ultra生成具有超逼真的人际交互、建筑元素和复杂景观的图像​。

1.1.1.8.1 image4_standard

从​ FF - Firefly Services Tech Insiders ​集合中选择名为​ POST - Firefly - T2I V4 ​的请求，并转到该请求的​ Headers。

您会注意到该请求的URL与​ Firefly Services API，文本2图像，图像3 ​请求不同，即​ https://firefly-api.adobe.io/v3/images/generate。 此URL指向​ https://firefly-api.adobe.io/v3/images/generate-async。 在URL中添加​ -async ​意味着您使用的是异步终结点。

在​ 标头 ​变量中，您会注意到名为​ x-model-version ​的新变量。 这是与Firefly Image 4和Image 4 Ultra交互时所需的标头。 要在生成图像时使用Firefly Image 4或Image 4 Ultra，则应将标头的值设置为image4_standard或image4_ultra。 在此示例中，您将使用image4_standard。

如果您未将​ x-model-version ​设置为image4_standard或image4_ultra，则Firefly Services当前将默认使用image3。

转到请求的​ 正文。 您应该会在正文中看到，正在请求4个图像变体。 提示与以前相比没有变化，并且仍在请求生成字段​ 中的 ​马。 单击​ 发送

然后您会立即得到响应。 此响应不包含已生成图像的图像URL，而是包含您启动的作业的状态报告的URL，并且包含另一个允许您取消正在运行的作业的URL。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。

然后，您将看到刚刚启动的图像生成作业的状态报表。 验证字段​ 状态，因为该字段可能设置为​ 正在运行，这意味着作业尚未完成。 在此示例中，作业状态设置为​ succeeded，这意味着已生成您请求的图像。

在响应中向下滚动一点，您随后应该会看到Adobe Firefly Services返回的共4个图像变体。 单击（或复制）其中一个图像的URL，然后在浏览器中将其打开。

然后，您应该会在字段​ 中看到 ​匹马的超真实图像。

1.1.1.8.2 image4_ultra

从​ FF - Firefly Services Tech Insiders ​集合返回名为​ POST - Firefly - T2I V4 ​的请求，并转到请求的​ Headers。

将变量​ x-model-version ​更改为image4_ultra。 在此示例中，您将使用image4_ultra。

转到请求的​ 正文。 在正文中，将图像变体的数量更改为1，就像Firefly Image 4 Ultra一样，一次只能生成1个图像。 提示与以前相比没有变化，并且仍在请求生成字段​ 中的 ​马。 单击​ 发送

响应中再次包含已启动作业的状态报告的URL，并且包含另一个允许您取消正在运行的作业的URL。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。

然后，您将看到刚刚启动的图像生成作业的状态报表。 验证字段​ 状态，因为该字段可能设置为​ 正在运行，这意味着作业尚未完成。 在此示例中，作业状态设置为​ succeeded，这意味着已生成您请求的图像。

然后，您应该会在字段​ 中看到 ​匹马的超真实图像。

负面提示

如果您希望请求Firefly不要在将要生成的图像中包含某些内容，您可以在使用API时包含字段negativePrompt（此选项当前未向UI公开）。 例如，如果您不希望在执行字段​ 中的提示 ​马时包含任何花，则可以在API请求的​ Body ​中指定此内容：

"negativePrompt": "no flowers",

从​ FF - Firefly Services技术内部人士 ​集合转到请求​ POST - Firefly - T2I V4，并转到请求的​ Body。 将以上文本粘贴到请求正文中。 单击​ 发送。

您应该会看到此内容。

要检查正在运行的作业的状态报告，请从​ FF - Firefly技术内部人士 ​集合中选择名为​ GET - Firefly Services — 获取状态报告 ​的请求。 单击以将其打开，然后单击​ 发送。 选择所生成图像的URL并在浏览器中将其打开。

然后您会看到生成的图像，该图像不应包含任何花朵。

后续步骤

转到使用Microsoft Azure和预签名URL优化您的Firefly进程

返回Adobe Firefly Services概述

返回所有模块