API 操作
上次更新日期：
2025年7月15日
适用于企业。
本页介绍了 Firefly Services API 和 Firefly Creative Production 操作的功能，以及如何为每个操作定义操作。
Firefly Services
Firefly API*
| API 操作 | 功能 | 拥有组织 | 操作定义 |
|---|---|---|---|
| 文字生成图像 | 根据文本提示生成图像 | 1 次操作 = 1 张由 Firefly 基础模型或自定义模型生成的图像 | |
| 带有结构参考的文字生成图像 | 根据提示生成图像，并带有可选的参考图像以匹配结构 | 1 次操作 = 1 张由 Firefly 基础模型或自定义模型生成的图像 | |
| 带有样式参考的文字生成图像 | 根据提示生成图像，并带有可选的参考图像以匹配样式 | 1 次操作 = 1 张由 Firefly 基础模型或自定义模型生成的图像 | |
| 生成式填充 | 使用可选提示填充图像的遮罩区域 | 1 次操作 = 使用基础 Firefly 模型生成 1 张图像 | |
| 生成式扩展 | 将图像扩展至新的尺寸/纵横比 | 1 次操作 = 使用基础 Firefly 模型生成 1 张图像 | |
| 生成类似图像 | 根据参考图像生成相似图像 | 1 次操作 = 使用基础 Firefly 模型生成 1 张图像 | |
| 生成物体合成 | 上传一张图片（带或不带遮罩），例如产品照片，并利用文字提示生成以产品为特色的无缝合成场景 | 1 次操作 = 使用基础 Firefly 模型生成 1 张图像 | |
| 生成式视频 | 根据文本提示、参考图像或两者的组合生成逼真或动画视频剪辑。 | 视频模型 1，540p 分辨率 | 0.4 次操作 = 生成 1 秒视频 |
| 视频模型 1，720p 分辨率 | 1 次操作 = 生成 1 秒视频 | ||
| 视频模型 1，1080p 分辨率 | 2 次操作 = 生成 1 秒视频 |
* Firefly API 包含允许在每次 API 调用时生成多幅图像的参数。
Photoshop API
|
|
功能 |
操作定义 |
|---|---|---|
|
移除背景 |
隔离图像中感兴趣的主题并移除背景 |
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 操作 |
功能 |
操作定义 |
|---|---|---|
|
拉直图像 |
自动拉直图像 |
1 次操作 = 1 次 API 调用 |
|
自动色调 |
将自动色调应用于图像 |
1 次操作 = 1 次 API 调用 |
|
编辑图像 |
对照片进行 Lr 调整，包括曝光、对比度、细节等。 |
1 次操作 = 1 次 API 调用 |
|
应用预设 |
将 Lr 预设应用于照片 |
1 次操作 = 1 次 API 调用 |
|
应用 XMP |
将 XMP 元数据添加到照片 |
1 次操作 = 1 次 API 调用 |
InDesign APIs
|
API 操作 |
功能 |
操作定义 |
|---|---|---|
|
数据合并 |
利用 InDesign 标记文档和 CSV 文件中的变量字段生成多种资产变体 |
1 个操作 = 1 个输出页面 |
|
演绎版 |
从 InDesign 文档创建 JPEG、PNG 或 PDF |
1 个操作 = 1 个输出页面 |
|
自定义脚本 |
使用 InDesign 功能创建和执行自定义脚本 |
1操作= 1输出*或输入页（以较高者为准） *输出包括通过“保存”、“另存为”或“保存副本”保存的所有文件，以及通过“导出”创建的所有文件。 |
视频和音频 API
|
API 操作 |
功能 |
操作定义 |
|---|---|---|
|
重新构架 |
识别视频中的动作并根据不同的宽高比重新调整剪辑 |
|
|
文字生成头像 |
将文本脚本转换为具有逼真的人类头像的视频，并提供各种预先拍摄的头像选择和自然的声音 |
1 操作 = 5 秒输出视频 |
|
文字生成语音 |
将书面文本转换为口头语音，使企业能够创建动态音频 |
1 次操作 = 10 分钟输出语音 |
视频和音频 API、附加组件
| API 操作 | 功能 | 操作定义 |
|---|---|---|
| 转录 | 为音频和视频内容生成原语言或翻译语言的文字记录和字幕 | 1 次操作 = 10 分钟输入视频或音频 |
| 配音 | 通过可选的唇形同步功能自动进行音频和视频语音翻译，无论背景噪音和音乐如何，都能产生高质量的配音输出 | 无嘴型同步：1 次操作 = 10 秒输出视频或音频 |
| 带嘴型同步：1 次操作 = 5 秒输出视频 |
内容标记 API
|
API 操作 |
功能 |
操作定义 |
|---|---|---|
|
颜色标记 |
给定图像，可计算出像素颜色直方图，并按主色调将其排序到桶中 |
1 次操作 = 每个资产 1 次 API 调用 |
|
关键词标记 |
给定文本文档，关键字标记服务会自动提取最能描述文档主题的关键字或关键短语 |
1 次操作 = 每个资产 1 次 API 调用 |
|
光学字符识别 |
给定图像，可以指示图像中是否存在文本。 如果存在文本，OCR 可以返回文本 |
1 次操作 = 每个资产 1 次 API 调用 |
Substance 3D API
| API 操作 | 功能 | 拥有组织 | 操作定义 |
|---|---|---|---|
| 生成 3D 对象复合 API** | 将 3D 对象无缝合成到 Firefly 生成的 2D 场景中，以创建像素完美的保真合成，具有逼真的灯光、阴影和纹理 | Firefly 图像模型 4：最长边小于或等于 2000 像素 | 2 次操作 = 1 张输出图像（或变体） |
Firefly 图像模型 4：最长边大于 2000 像素 |
3 次操作 = 1 张输出图像（或变体） |
||
Firefly 图像模型 4 Ultra：最长边小于或等于 2000 像素 |
3 次操作 = 1 张输出图像（或变体） |
||
Firefly 图像模型 4 Ultra：最长边大于 2000 像素 |
4 次操作 = 1 张输出图像（或变体） |
||
| 渲染 3D 对象 API** | 通过自动创建具有精确光照、阴影和反射的逼真产品包装图，大规模渲染像素级完美的产品包装图 | 最长边小于或等于 2000 像素 | 1 次操作 = 1 张输出图像 |
最长边大于 2000 像素 |
2 次操作 = 1 张输出图像 |
||
| 创建 3D 场景 API | 将多个 3D 资源合并到一个连贯且详细的场景中，该场景旨在托管数字孪生 | 1 个操作 = 1 个输出文件 | |
| 转换 3D 文件 API | 将 FBX 和 OBJ 等格式的现有 3D 内容转换为 gITF 和 USD 等更通用的文件格式 | 1 个操作 = 1 个输出文件 | |
| 描述 3D 场景 API | 生成有关 3D 场景内容的详细统计信息 | 免费 |
** 生成 3D 对象合成 API 和渲染 3D 对象 API 包含允许每次 API 调用生成多个图像的参数。
Firefly Creative Production
|
操作 |
功能 |
操作定义 |
|---|---|---|
|
删除背景（平面图像输出） |
隔离图像中感兴趣的主题，去除背景并输出平面图像文件 |
1 个操作 = 1 个输出文件 |
|
裁剪 |
裁剪图像尺寸或纵横比 |
2 个操作 = 1 个输出文件 |
|
颜色分级 |
自动调整色调或将 Lightroom 预设应用于批量上传的图像 |
1 个操作 = 1 个输出文件 |
