API-Aktion
Für Unternehmen.
Dieses Dokument beschreibt die im Rahmen des Firefly Services-Angebots verfügbaren APIs und Funktionen für Firefly, Photoshop, Lightroom, Video und Audio sowie Content Tagging (unterstützt durch die Sensei-Plattform).
Firefly-APIs
|
Funktion |
Vorgangsdefinition (1) |
---|---|---|
Text zu Bild |
Generiert Bilder auf Grundlage eines Text-Prompts. |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
Generatives Füllen |
Füllt den maskierten Bereich eines Bildes mit einem optionalen Prompt aus. |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
Generatives Erweitern |
Erweitert ein Bild auf eine neue Größe/ein neues Seitenverhältnis. |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
Text zu Bild mit Stilreferenz |
Generiert Bilder auf Grundlage eines Prompts mit optionalem Referenzbild als Stilvorgabe |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
Text zu Bild mit Strukturreferenz |
Generiert Bilder auf Grundlage eines Prompts mit optionalem Referenzbild als Strukturvorgabe |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
Ähnliche Bilder generieren |
Generiert ähnliche Bilder auf der Grundlage des Referenzbildes. |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
Objekt-Composite generieren |
Lade ein Bild (mit oder ohne Maske) hoch, z. B. ein Produktfoto, und gib einen Text-Prompt an, um eine nahtlose Composite-Szene um das Produkt zu generieren. |
1 Vorgang = 1 Standardbild, das mit dem grundlegenden Firefly-Modell generiert wurde |
(1) Ein Standardbild bezeichnet ein Bild mit einer Breite von bis zu 2000 x 2000 Pixel. API-Anfragen können dazu führen, dass mehrere Bilder generiert werden. Preise decken keine zukünftigen Funktionen ab, Bilder mit „benutzerdefinierten Modellerweiterungen“ zu generieren.
Begrenzungen der Dateigröße
Bei Bild-Assets, die für generatives Füllen, generatives Erweitern oder generative Anpassung verwendet werden, ist die Dateigröße pro erfolgreichem API-Aufruf auf 15 MB (Megabyte) begrenzt.
Creative Cloud-APIs
Photoshop-APIs
API-Aktion |
Funktion |
Vorgangsdefinition (2) |
---|---|---|
Hintergrund entfernen |
Isoliert das relevante Motiv in einem Bild und entfernt den Hintergrund. |
1 Vorgang = 1 API-Aufruf pro Asset |
Maske erstellen |
Isoliert ein relevantes Motiv in einem Bild (Menschen, Objekte usw.) und generiert eine Bildmaske. |
1 Vorgang = 1 API-Aufruf pro Asset |
Ausgabedarstellungen erstellen |
Erstellt flache Bilddarstellungen einer PSD. |
1 Vorgang = 1 API-Aufruf pro Asset |
actionJSON erstellen |
Konvertiert eine ATN-Datei in ein actionJSON-Format. |
1 Vorgang = 1 API-Aufruf pro Asset |
actionJSON ausführen |
Führt eine Photoshop-Aktion mit actionJSON-Format aus. |
1 Vorgang = 1 API-Aufruf pro Asset |
Photoshop-Aktionen ausführen |
Führt eine Photoshop-Aktionsdatei mit einer PSD-, JPEG-, PNG- oder TIFF-Datei aus. |
1 Vorgang = 1 API-Aufruf pro Asset |
Smartobjekt ersetzen |
Ersetzt ein Smartobjekt in einer PSD-Datei. |
1 Vorgang = 1 API-Aufruf pro Asset |
Produkt zuschneiden |
Schneidet ein Bild intelligent zu, wobei das relevante Motiv sichtbar bleibt. |
1 Vorgang = 1 API-Aufruf pro Asset |
Tiefenunschärfe |
Wendet Tiefenunschärfe auf eine Bildeingabe an. |
1 Vorgang = 1 API-Aufruf pro Asset |
Textebene bearbeiten |
Ändert Inhalt einer Textebene in einer PSD-Datei, z. B. für die Lokalisierung. |
1 Vorgang = 1 API-Aufruf pro Asset |
PSD-Bearbeitungen anwenden |
Wendet grundlegende Bearbeitungen von Ebenen (Name, Status usw.) an, fügt Korrektur-, Pixel- und Formebenen hinzu oder bearbeitet diese. |
1 Vorgang = 1 API-Aufruf pro Asset |
Neue PSD erstellen |
Erstellt eine neue PSD-Datei mit Ebenen. |
1 Vorgang = 1 API-Aufruf pro Asset |
Zeichenfläche erstellen |
Erstellt Zeichenflächen aus mehreren PSD-Eingaben. |
1 Vorgang = 1 API-Aufruf pro Asset |
Manifest abrufen |
Extrahiert Metadaten aus dem PSD-Dokument, einschließlich allgemeiner Datei- und Ebeneninformationen. |
1 Vorgang = 1 API-Aufruf pro Asset |
Lightroom-APIs
API-Aktion |
Funktion |
Vorgangsdefinition (2) |
---|---|---|
Bild ausrichten |
Richtet ein Bild automatisch aus. |
1 Vorgang = 1 API-Aufruf pro Asset |
Auto-Tonwert |
Wendet Auto-Tonwert auf ein Bild an. |
1 Vorgang = 1 API-Aufruf pro Asset |
Bild bearbeiten |
Passt Lr-Korrekturen an einem Foto an, einschließlich Belichtung, Kontrast und Detail. |
1 Vorgang = 1 API-Aufruf pro Asset |
Vorgabe anwenden |
Wendet eine Lr-Vorgabe auf ein Foto an. |
1 Vorgang = 1 API-Aufruf pro Asset |
XMP anwenden |
Fügt einem Foto XMP-Metadaten hinzu. |
1 Vorgang = 1 API-Aufruf pro Asset |
InDesign-APIs
API-Aktion |
Funktion |
Vorgangsdefinition (2) |
---|---|---|
Datenzusammenführung |
Generiert mehrere Asset-Varianten mithilfe von variablen Feldern aus einem getaggten InDesign-Dokument und einer CSV-Datei. |
1 Operation = 1 Ausgabeseite |
Rendition |
Erstellt eine JPEG-, PNG- oder PDF-Datei aus dem InDesign-Dokument. |
1 Operation = 1 Ausgabeseite |
Video- und Audio-APIs
API-Aktion |
Funktion |
Vorgangsdefinition |
---|---|---|
Reframe |
Identifiziert Aktionen in einem Video und reframet den Clip für unterschiedliche Seitenverhältnisse. |
|
Video- und Audio-APIs, Add-on
API-Aktion |
Funktion |
Vorgangsdefinition |
---|---|---|
Audio übersetzen |
Automatisiert die Audio- und Video-Sprachübersetzung mit optionaler Lippensynchronisation. Dies ermöglicht eine qualitativ hochwertige Synchronisation, unabhängig von Hintergrundgeräuschen und Musik. |
1 Vorgang = 10 Sek. des Ausgabevideos |
Lippensynchronisation |
Erzielt eine präzise Lippensynchronisation mit akkurater Lippenkomposition am Mund des Sprechenden und erstellt hochwertige zusammengesetzte Videos mit Lippensynchronisation. |
1 Vorgang = 5 Sek. des Ausgabevideos |
Content Tagging-APIs
API-Aktion |
Funktion |
Vorgangsdefinition (2) |
---|---|---|
Farb-Tagging |
Kann aus einem Bild ein Histogramm der Pixelfarben berechnen und nach dominanten Farben in Gruppen sortieren. |
1 Vorgang = 1 API-Aufruf pro Asset |
Keyword-Tagging |
Der Stichwort-Tagging-Dienst extrahiert automatisch Stichwörter oder Stichwortausdrücke aus einem Textdokument, die das Thema des Dokuments am besten beschreiben. |
1 Vorgang = 1 API-Aufruf pro Asset |
OCR |
Kann bei einem Bild angeben, ob Text im Bild vorhanden ist. Wenn Text vorhanden ist, kann OCR den Text zurückgeben. |
1 Vorgang = 1 API-Aufruf pro Asset |
(2) API-Aktionen können für mehrere Assets ausgeführt werden. Wenn ein Kunde beispielsweise eine API-Aktion für einhundert (100) Assets anfordert, zählt diese API-Aktion als einhundert (100) Vorgänge. Zur Verdeutlichung: API-Aktionen zur Statusabfrage verbrauchen keine Vorgänge.
Begrenzungen der Dateigröße
Bei Bild-Assets (z. B. PSD- und PNG-Dateien) beträgt die maximale Dateigröße für die Creative Cloud-API pro erfolgreichem API-Aufruf 300 MB (Megabyte).
Bei der Nutzung der Photoshop- und Lightroom-APIs durch den Kunden ist die Dateigröße pro erfolgreichem API-Aufruf für ein Asset auf die für den jeweiligen Asset-Typ festgelegte Dateigrößenbegrenzung pro erfolgreichem API-Aufruf begrenzt. Überschreitet der Kunde die maximale Dateigröße pro erfolgreichem API-Aufruf, wird dem Kunden ein weiterer erfolgreicher API-Aufruf in Rechnung gestellt.
Zum Beispiel zählt eine PSD-Datei mit 200 MB als ein erfolgreicher API-Aufruf, eine PSD-Datei mit 500 MB als zwei erfolgreiche API-Aufrufe und eine PSD-Datei mit 700 MB als drei erfolgreiche API Aufrufe.
Weitere
Firefly Kreative Produktion
API-Aktion |
Funktion |
Vorgangsdefinition |
---|---|---|
Hintergrund entfernen (flache Bildausgabe) |
Isoliert das gewünschte Motiv in einem Bild, entfernt den Hintergrund und gibt eine flache Bilddatei aus. |
1 Operation = 1 Ausgabedatei |
Hintergrund entfernen (überlagerte PSD-Ausgabe) |
Isoliert das gewünschte Motiv in einem Bild, entfernt den Hintergrund und gibt eine PSD-Datei mit Ebenen aus. |
3 Operationen = 1 Ausgabedatei |
Zuschneiden |
Schneidet Bildgrößen oder Seitenverhältnisse zu. |
2 Operationen = 1 Ausgabedatei |