API-actie
In dit document worden de beschikbare API's en functies beschreven voor Firefly, Photoshop, Lightroom en Content Tagging (mogelijk gemaakt door Sensei Platform) als onderdeel van het aanbod met Firefly-services.
Firefly-API's
|
Functie |
Handelingsdefinitie (1) |
---|---|---|
Tekst naar afbeelding |
Afbeeldingen genereren op basis van een tekstopdracht |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
Generatief vullen |
Het gemaskeerde gebied van een afbeelding vullen met een optionele opdracht |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
Generatief uitbreiden |
Een afbeelding uitbreiden naar nieuwe afmetingen/beeldverhouding |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
Tekst naar afbeelding met stijlreferentie |
Afbeeldingen genereren op basis van een opdracht met een optionele referentieafbeelding voor de stijl |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
Tekst naar afbeelding met structuurreferentie |
Afbeeldingen genereren op basis van een opdracht met een optionele referentieafbeelding voor de structuur |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
Vergelijkbare afbeeldingen genereren |
Vergelijkbare afbeeldingen genereren op basis van de referentieafbeelding. |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
Objectcompositie genereren |
Upload een afbeelding (met of zonder masker), zoals een productfoto, en gebruik een tekstopdracht om een naadloze scène met het product te genereren. |
1 handeling = 1 standaardafbeelding gegenereerd met het Firefly-basismodel |
(1) Een standaardafbeelding betekent een afbeelding van maximaal 2000 x 2000 pixels. API-verzoeken kunnen ertoe leiden dat er meerdere afbeeldingen worden gegenereerd. De prijzen gelden niet voor toekomstige functies om afbeeldingen te genereren met behulp van 'aangepaste modelextensies'.
Limieten voor de bestandsgrootte
Voor afbeeldingsassets die worden gebruikt voor Generatief vullen, Generatief uitbreiden of Generatief afstemmen, is de maximale bestandsgrootte per succesvolle API-aanroep 15 megabytes (MB).
Creative Cloud-API's
Photoshop-API's
API-actie |
Functie |
Handelingsdefinitie (2) |
---|---|---|
Achtergrond verwijderen |
Het hoofdonderwerp van een afbeelding isoleren en de achtergrond verwijderen |
1 handeling = 1 API-aanroep per asset |
Masker maken |
Een onderwerp in een afbeelding (mensen, voorwerpen enz.) isoleren en een afbeeldingsmasker genereren |
1 handeling = 1 API-aanroep per asset |
Weergaven maken |
Afbeeldingsweergaven met één laag maken van een PSD |
1 handeling = 1 API-aanroep per asset |
actionJSON maken |
.atn-bestand converteren naar een actionJSON-indeling |
1 handeling = 1 API-aanroep per asset |
actionJSON uitvoeren |
Een Photoshop-actie met de actionJSON-indeling uitvoeren |
1 handeling = 1 API-aanroep per asset |
Photoshop-acties uitvoeren |
Een Photoshop-actiebestand uitvoeren op basis van een PSD, JPEG, PNG of TIFF |
1 handeling = 1 API-aanroep per asset |
Slim object vervangen |
Slim object in een PSD vervangen |
1 handeling = 1 API-aanroep per asset |
Productuitsnede |
Een afbeelding slim bijsnijden, waarbij het hoofdonderwerp in beeld blijft |
1 handeling = 1 API-aanroep per asset |
Dieptevervaging |
Dieptevervaging toepassen op een invoerafbeelding |
1 handeling = 1 API-aanroep per asset |
Tekstlaag bewerken |
De inhoud van een tekstlaag in een PSD wijzigen, bijv. voor lokalisatie |
1 handeling = 1 API-aanroep per asset |
PSD-bewerkingen toepassen |
Basislaagbewerkingen toepassen (naam, status enz.), aanpassings-, pixel- en vormlagen toevoegen/bewerken |
1 handeling = 1 API-aanroep per asset |
Nieuwe PSD maken |
Een nieuwe PSD met lagen maken |
1 handeling = 1 API-aanroep per asset |
Een tekengebied maken |
Tekengebieden maken van meerdere PSD-invoerbestanden |
1 handeling = 1 API-aanroep per asset |
Manifest ophalen |
Metadata extraheren uit een PSD-document, inclusief algemene bestands- en laaginformatie |
1 handeling = 1 API-aanroep per asset |
Lightroom-API's
API-actie |
Functie |
Handelingsdefinitie (2) |
---|---|---|
Afbeelding rechtzetten |
Een afbeelding automatisch rechtzetten |
1 handeling = 1 API-aanroep per asset |
Automatische tint |
De tint van een afbeelding automatisch aanpassen |
1 handeling = 1 API-aanroep per asset |
Afbeelding bewerken |
Lr-aanpassingen aan een foto aanpassen, inclusief belichting, contrast, detail enz. |
1 handeling = 1 API-aanroep per asset |
Voorinstelling toepassen |
Lr-voorinstelling toepassen op een foto |
1 handeling = 1 API-aanroep per asset |
XMP toepassen |
XMP-metadata toevoegen aan een foto |
1 handeling = 1 API-aanroep per asset |
Content Tagging-API's
API-actie |
Functie |
Handelingsdefinitie (2) |
---|---|---|
Kleuren taggen |
Kan voor een afbeelding een histogram van pixelkleuren berekenen en deze sorteren in groepen dominante kleuren |
1 handeling = 1 API-aanroep per asset |
Trefwoorden taggen |
Bij een tekstdocument extraheert de service voor trefwoordtagging automatisch trefwoorden of trefwoordgroepen die het onderwerp van het document het beste beschrijven |
1 handeling = 1 API-aanroep per asset |
OCR |
Kan voor een afbeelding aangeven of er tekst in de afbeelding aanwezig is. Als er tekst aanwezig is, kan OCR de tekst produceren. |
1 handeling = 1 API-aanroep per asset |
(2) API-acties kunnen voor meerdere assets worden uitgevoerd. Als een klant bijvoorbeeld een API-actie aanvraagt voor honderd (100) assets, wordt zo'n API-actie geteld als honderd (100) handelingen. Voor de duidelijkheid: API-acties voor het opvragen van de status verbruiken geen handelingen.
Limieten voor de bestandsgrootte
Voor afbeeldingsassets (bijvoorbeeld PSD- en PNG-bestanden) is de bestandslimiet voor Creative Cloud-API's 300 megabyte (MB) per geslaagde API-aanroep.
Als de klant de Photoshop- en Lightroom-API's gebruikt, is de bestandsgrootte per geslaagde API-aanroep voor een asset beperkt tot de maximale bestandsgrootte per geslaagde API-aanroep zoals beschreven voor elk type asset. Als de klant de maximale bestandsgrootte per geslaagde API-aanroep overschrijdt, wordt dit doorberekend als extra geslaagde API-aanroepen.
Een PSD-bestand van 200 MB telt bijvoorbeeld als één geslaagde API-aanroep, een PSD-bestand van 500 MB als twee geslaagde API-aanroepen en een PSD-bestand van 700 MB als drie geslaagde API-aanroepen.