API 操作
上次更新日期：
2025年5月12日
适用于企业。
本文档介绍了 Firefly 服务产品中 Firefly、Photoshop、Lightroom、视频和音频以及内容标记（由 Sensei Platform 提供支持）的可用 API 和功能。
Firefly API
|
|
功能 |
操作定义（1） |
|---|---|---|
|
文字生成图像 |
根据文本提示生成图像 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
|
生成式填充 |
使用可选提示填充图像的遮罩区域 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
|
生成式扩展 |
将图像扩展为新的尺寸/纵横比 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
|
通过样式参考实现文字生成图像 |
根据提示生成图像，可选择参考图像以匹配风格 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
|
通过结构参考实现文字生成图像 |
根据提示生成图像，可选择参考图像以匹配结构。 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
|
生成类似图像 |
根据参考图像生成类似图像。 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
|
生成物体合成 |
上传图像（带或不带遮罩，如产品照片），并利用文字提示生成包含产品的无缝合成场景。 |
1 次操作 = 1 个使用基础 Firefly 模型生成的标准图像 |
（1）标准图像是指图像宽度不超过 2000 x 2000 像素。 API 请求可能会生成多个图像。 定价不包括未来使用“自定义模型扩展”生成图像的任何功能。
文件大小限制
对于用于生成式填充、生成式扩展或生成式匹配的图像资源，每次成功调用 API 的文件大小限制最多为 15 兆字节（或 MB）。
Creative Cloud API
Photoshop API
|
API 操作 |
功能 |
操作定义（2） |
|---|---|---|
|
移除背景 |
隔离图像中感兴趣的主题并移除背景 |
1 次操作 = 每个资产 1 次 API 调用 |
|
创建蒙版 |
隔离图像中感兴趣的主题（人、物体等）并生成图像蒙版 |
1 次操作 = 每个资产 1 次 API 调用 |
|
创建演绎版 |
创建 PSD 的平面图像表示 |
1 次操作 = 每个资产 1 次 API 调用 |
|
创建 actionJSON |
将 .atn 文件转换为 actionJSON 格式 |
1 次操作 = 每个资产 1 次 API 调用 |
|
执行 actionJSON |
使用 actionJSON 格式执行 Photoshop Action |
1 次操作 = 每个资产 1 次 API 调用 |
|
执行 Photoshop Action |
针对 PSD、JPEG、PNG 或 TIFF 执行 Photoshop Action 文件 |
1 次操作 = 每个资产 1 次 API 调用 |
|
替换智能对象 |
替换 PSD 中的智能对象 |
1 次操作 = 每个资产 1 次 API 调用 |
|
产品裁切 |
智能裁切图像，保持感兴趣的主题清晰可见 |
1 次操作 = 每个资产 1 次 API 调用 |
|
深度模糊 |
将深度模糊应用于图像输入 |
1 次操作 = 每个资产 1 次 API 调用 |
|
编辑文本层 |
更改 PSD 中文本图层的内容，例如用于本地化 |
1 次操作 = 每个资产 1 次 API 调用 |
|
应用 PSD 编辑 |
应用基本图层编辑（名称、状态等）、添加/编辑调整、像素和形状图层 |
1 次操作 = 每个资产 1 次 API 调用 |
|
创建新的 PSD |
创建带有图层的新 PSD |
1 次操作 = 每个资产 1 次 API 调用 |
|
创建画板 |
从多个 PSD 输入创建画板 |
1 次操作 = 每个资产 1 次 API 调用 |
|
获取清单 |
从 PSD 文档中提取元数据，包括一般文件和图层信息 |
1 次操作 = 每个资产 1 次 API 调用 |
Lightroom API
|
API 操作 |
功能 |
操作定义（2） |
|---|---|---|
|
拉直图像 |
自动拉直图像 |
1 次操作 = 每个资产 1 次 API 调用 |
|
自动色调 |
将自动色调应用于图像 |
1 次操作 = 每个资产 1 次 API 调用 |
|
编辑图像 |
对照片进行 Lr 调整，包括曝光、对比度、细节等。 |
1 次操作 = 每个资产 1 次 API 调用 |
|
应用预设 |
将 Lr 预设应用于照片 |
1 次操作 = 每个资产 1 次 API 调用 |
|
应用 XMP |
将 XMP 元数据添加到照片 |
1 次操作 = 每个资产 1 次 API 调用 |
InDesign APIs
|
API 操作 |
功能 |
操作定义（2） |
|---|---|---|
|
数据合并 |
利用 InDesign 标记文档和 CSV 文件中的变量字段生成多种资产变体。 |
1 个操作 = 1 个输出页面 |
|
演绎版 |
从 InDesign 文档创建 JPEG、PNG 或 PDF。 |
1 个操作 = 1 个输出页面 |
|
自定义脚本 |
使用 InDesign 功能创建和执行自定义脚本。 |
1操作= 1输出*或输入页（以较高者为准） *输出包括通过“保存”、“另存为”或“保存副本”保存的所有文件，以及通过“导出”创建的所有文件。 |
视频和音频 API
|
API 操作 |
功能 |
操作定义（2） |
|---|---|---|
|
重新构架 |
识别视频中的动作并重新构建剪辑以适应不同的纵横比。 |
|
|
文字生成头像 |
将文字脚本转换为具有逼真的人类头像的视频，并提供多种预先拍摄的头像选择 |
1 操作 = 5 秒输出视频 |
|
文字生成语音 |
将书面文字转换为口头语音，使企业能够创建动态音频；与文字生成头像一起使用 |
1 操作 = 10 分钟输出视频 |
视频和音频 API、附加组件
|
API 操作 |
功能 |
操作定义（2） |
|---|---|---|
|
翻译音频 |
通过可选的口型同步功能自动进行音频和视频语音翻译，无论背景噪音和音乐如何，都能产生高质量的配音输出。 |
1 操作 = 10 秒输出视频 |
|
嘴形同步 |
通过精确的唇形组合实现演讲者嘴部的精确唇形同步，并创建高质量合成的唇形同步视频。 |
1 操作 = 5 秒输出视频 |
内容标记 API
|
API 操作 |
功能 |
操作定义（2） |
|---|---|---|
|
颜色标记 |
给定图像，可计算出像素颜色直方图，并按主色调将其排序到桶中 |
1 次操作 = 每个资产 1 次 API 调用 |
|
关键词标记 |
给定文本文档，关键字标记服务会自动提取最能描述文档主题的关键字或关键短语 |
1 次操作 = 每个资产 1 次 API 调用 |
|
光学字符识别 |
给定图像，可以指示图像中是否存在文本。 如果存在文本，OCR 可以返回文本 |
1 次操作 = 每个资产 1 次 API 调用 |
(2) API 操作可以针对多个资产运行。 例如，如果客户请求针对一百 (100) 项资产的 API 操作，则此类 API 操作将被计为一百 (100) 项操作。 为清楚起见，状态轮询 API 操作不会消耗操作。
文件大小限制
对于图像资源（例如 PSD 和 PNG 文件），每次成功调用 API 的 Creative Cloud API 文件大小限制最多为 300 兆字节（或 MB）。
在客户使用 Photoshop 和 Lightroom API 时，资产每次成功调用 API 的文件大小仅限于针对每种资产类型规定的每次成功调用 API 的文件大小限制。 如果客户每次成功调用 API 的文件大小超过了限制，则客户将需要额外支付成功调用 API 的费用。
例如，200 MB PSD 文件将计为一次成功的 API 调用，500 MB PSD 文件将计为两次成功的 API 调用，而 700 MB PSD 文件将计为三次成功的 API 调用。
其他的
Firefly 创意制作
|
API 操作 |
功能 |
操作定义 |
|---|---|---|
|
删除背景（平面图像输出） |
隔离图像中感兴趣的主题，去除背景并输出平面图像文件 |
1 个操作 = 1 个输出文件 |
|
删除背景（分层 PSD 输出） |
隔离图像中感兴趣的主题，删除背景，并输出分层的 PSD 文件 |
3 个操作 = 1 个输出文件 |
|
裁剪 |
裁剪图像尺寸或纵横比 |
2 个操作 = 1 个输出文件 |
|
颜色分级 |
自动调整色调或将 Lightroom 预设应用于批量上传的图像 |
1 个操作 = 1 个输出文件 |
