Akce API
Naposledy aktualizováno
24. 11. 2025
Platí pro podniky.
Tato stránka popisuje možnosti rozhraní API služeb Firefly Services a způsob definování operací pro každou z nich.
Služby Firefly
Rozhraní API Firefly*
| Akce API | Možnost | Podmínka | Definice operace |
|---|---|---|---|
| Generování obrázku | Generování obrázků na základě textového zadání | 1 operace = 1 obrázek vygenerovaný ze základního modelu Firefly nebo vlastních modelů | |
| Vyplnit obrázek | Vyplňte maskovanou oblast v obrázku volitelným zadáním | 1 operace = 1 obrázek vygenerovaný základním modelem Firefly | |
| Rozdělit obrázek | Zvětšete obrázek na novou velikost / poměr stran | 1 operace = 1 obrázek vygenerovaný základním modelem Firefly | |
| Generovat podobné obrázky | Generujte podobné obrázky na základě referenčního obrázku | 1 operace = 1 obrázek vygenerovaný základním modelem Firefly | |
| Generovat kompozici objektů | Nahrajte obrázek (s maskou nebo bez ní), například fotografii produktu, a použijte textové zadání k vygenerování plynulé složené scény s produktem | 1 operace = 1 obrázek vygenerovaný základním modelem Firefly | |
| Generovat video | Generujte fotorealistické nebo animované videoklipy z textového zadání, referenčních obrázků nebo jejich kombinace. | Video Model 1, rozlišení 540p | 0,4 operace = 1 sekunda vygenerovaného videa |
| Video Model 1, rozlišení 720p | 1 operace = 1 sekunda vygenerovaného videa | ||
| Video Model 1, rozlišení 1080p | 2 operace = 1 sekunda vygenerovaného videa |
* Rozhraní API Firefly obsahují parametry, které umožňují generování více obrázků při každém volání API.
Rozhraní API Photoshop
|
|
Možnost |
Definice operace |
|---|---|---|
|
Odstranění pozadí |
Izolování subjektu zájmu na obrázku a odstranění pozadí |
1 operace = 1 API volání |
|
Vytvoření masky |
Izolování subjektu zájmu na obrázku (lidé, předměty atd.) a vygenerování masky obrázku |
1 operace = 1 API volání |
|
Vytvoření vykreslení |
Vytvoření ploché obrazové reprezentace PSD |
1 operace = 1 API volání |
|
Vytvoření souboru actionJSON |
Převedení souboru ATN do formátu actionJSON |
1 operace = 1 API volání |
|
Spuštění souboru actionJSON |
Spuštění akce v aplikaci Photoshop pomocí souboru actionJSON |
1 operace = 1 API volání |
|
Spouštění akcí v aplikaci Photoshop |
Aplikování akce Photoshop na soubor PSD, JPEG, PNG nebo TIFF |
1 operace = 1 API volání |
|
Nahrazení chytrého objektu |
Nahrazení chytrého objektu v souboru PSD |
1 operace = 1 API volání |
|
Oříznutí produktu |
Inteligentní oříznutí obrazu tak, aby subjekt zájmu zůstal v záběru |
1 operace = 1 API volání |
|
Rozostření hloubky |
Použití rozostření do hloubky u vstupního obrázku |
1 operace = 1 API volání |
|
Úprava textové vrstvy |
Změna obsahu textové vrstvy v souboru PSD, např. při lokalizaci |
1 operace = 1 API volání |
|
Použití úprav PSD |
Použití základních úprav vrstvy (název, stav atd.), přidání/přizpůsobení vrstvy úprav, pixelů a tvarů |
1 operace = 1 API volání |
|
Vytvoření nového souboru PSD |
Vytvoření nového souboru PSD s vrstvami |
1 operace = 1 API volání |
|
Vytvoření kreslicího plátna |
Vytváření kreslicích pláten z více vstupních souborů PSD |
1 operace = 1 API volání |
|
Získání manifestu |
Extrahování metadat z dokumentu PSD, včetně obecných informací o souborech a vrstvách |
1 operace = 1 API volání |
|
Zpřesnit masku |
Vylepšit okraje a přesnost masky |
1 operace = 1 API volání |
|
Vyplnit maskovanou oblast |
Vyplnit maskovanou oblast pro dokončení obrázku |
1 operace = 1 API volání |
|
Maskovat rysy těla |
Vytvořit označenou masku pro každou část lidského těla na obrázku |
1 operace = 1 API volání |
|
Maskovat všechny objekty |
Vytvořit označenou masku pro každý objekt v obrázku |
1 operace = 1 API volání |
Rozhraní API Lightroom
|
Akce API |
Možnost |
Definice operace |
|---|---|---|
|
Narovnání obrázku |
Automatické narovnání obrázku |
1 operace = 1 API volání |
|
Automatický tón |
Použití automatického tónu na obrázek |
1 operace = 1 API volání |
|
Úprava obrázku |
Přizpůsobení úprav v aplikaci Lr na fotografii, včetně expozice, kontrastu, detailů atd. |
1 operace = 1 API volání |
|
Použití předvolby |
Použití předvolby Lr na fotografii |
1 operace = 1 API volání |
|
Použití metadat XMP |
Přidání metadat XMP k fotografii |
1 operace = 1 API volání |
API v aplikaci InDesign
|
Akce API |
Možnost |
Definice operace |
|---|---|---|
|
Sloučení dat |
Generujte několik variant datových zdrojů pomocí polí proměnných z dokumentu označeného aplikací InDesign a souboru CSV |
1 operace = 1 výstupní stránka |
|
Vykreslení |
Vytvořte soubory JPEG, PNG nebo PDF z dokumentu aplikace InDesign |
1 operace = 1 výstupní stránka |
|
Vlastní skripty |
Vytvořte a spusťte vlastní skripty pomocí funkcí aplikace InDesign |
1 operace = 1 výstupní* nebo vstupní stránka, podle toho, která hodnota je vyšší *Výstup zahrnuje všechny soubory uložené pomocí možnosti Uložit, Uložit jako nebo Uložit kopii a všechny soubory vytvořené pomocí možnosti Export. |
|
Seznam vlastních skriptů |
Seznam všech vlastních skriptů zaregistrovaných uživatelem |
Zdarma |
|
Získat podrobnosti o vlastním skriptu |
Načíst podrobnosti o konkrétním vlastním skriptu zaregistrovaném uživatelem |
Zdarma |
|
Odstranit vlastní skript |
Odstranit konkrétní vlastní skript zaregistrovaný uživatelem |
Zdarma |
|
Přemapovat odkazy |
Nahradit odkazy místních datových zdrojů odkazy datových zdrojů aplikace Experience Manager v souboru aplikace InDesign |
Zdarma |
|
Informace o dokumentu |
Získejte informace o dokumentu indesign, jako jsou dvoustrany, stránky, odkazy, písma, položky stránek, vrstvy atd. |
1 operace = 1 volání API |
Video & Audio API
| Akce API | Možnost | Podmínka | Definice operace |
|---|---|---|---|
| Změna formátu videa V1 | Identifikujte akce ve videu a změnit snímkování klipu pro různé poměry stran | <= 30 FPS | 1 operace = 1 minuta výstupního videa |
| > 30 a <= 60 FPS | 2 operace = 1 minuta výstupního videa | ||
| > 60 FPS | 4 operace = 1 minuta výstupního videa | ||
Změna formátu videa V2 |
Mění formát videí do různých poměrů stran.Podporuje sémantické uzamčení subjektu, které využívá prostý text k definování a sledování klíčových subjektů napříč scénami |
<= 30 FPS (se sémantickým uzamčením subjektu) |
1 operace = 1 minuta výstupního videa |
> 30 a <= 60 FPS (se sémantickým uzamčením subjektu) |
2 operace = 1 minuta výstupního videa |
||
> 60 FPS (se sémantickým uzamčením subjektu) |
4 operace = 1 minuta výstupního videa |
||
<= 30 FPS (bez sémantického uzamčení subjektu) |
1 operace = 1 minuta výstupního videa |
||
> 30 a <= 60 FPS (bez sémantického uzamčení subjektu) |
2 operace = 1 minuta výstupního videa |
||
> 60 FPS (bez sémantického uzamčení subjektu) |
4 operace = 1 minuta výstupního videa |
||
Převod textu na řeč |
Převeďte psaný text na mluvenou řeč, což firmám umožňuje vytvářet dynamický zvuk |
|
0,25 operace = 1 minuta výstupního videa |
Text na avatar |
Převeďte textové scénáře na videa s realistickými lidskými avatary s výběrem z různých předem natočených avatarů a přirozeně znějícími hlasy |
|
0,5 operace = 1 sekunda výstupního videa |
Video & Audio API, doplněk
| Akce API | Možnost | Podmínka | Definice operace |
|---|---|---|---|
| Přepis | Generujte přepisy a titulky pro audio a video obsah v původním nebo přeloženém jazyce | 1 operace = 10 minut vstupního videa nebo zvuku | |
| Dabujte | Automatizujte překlad zvuku a hlasu ve videu pomocí volitelné synchronizace řeči pro vytvoření špičkového dabingového výstupu bez ohledu na ruchy v pozadí a hudbu | Bez synchronizace rtů | 1 operace = 10 sekund výstupního videa nebo zvuku |
| Bez synchronizace rtů | 1 operace = 5 sekund výstupního videa |
Rozhraní API pro označování obsahu
|
Akce API |
Možnost |
Definice operace |
|---|---|---|
|
Označení barev |
Na základě daného obrázku umožňuje vypočítat histogram barev pixelů a seřadit je podle dominantních barev do segmentů |
1 operace = 1 API volání na datový zdroj |
|
Označování klíčových slov |
V případě textového dokumentu služba označování klíčových slov automaticky extrahuje klíčová slova nebo klíčové fráze, které nejlépe popisují předmět dokumentu |
1 operace = 1 API volání na datový zdroj |
|
OCR |
Dokáže indikovat, zda se v daném obrázku nachází text. Pokud je v něm text nachází, funkce OCR jej může přečíst |
1 operace = 1 API volání na datový zdroj |
Rozhraní API Substance 3D
| Akce API | Možnost | Podmínka | Definice operace |
|---|---|---|---|
| Generovat 3D kompozici objektů* | Bezproblémově skládejte 3D objekty do 2D scén generovaných aplikací Firefly a vytvářejte kompozice s dokonalou věrností pixelů, fotorealistickým osvětlením, stíny a texturami | Obrazový model Firefly 4: Maximálně 2000 pixelů na nejdelší straně | 2 operace = 1 výstupní obrázek (nebo varianta) |
Obrazový model Firefly 4: Více než 2000 pixelů na nejdelší straně |
3 operace = 1 výstupní obrázek (nebo varianta) |
||
Obrazový model Firefly 4 Ultra: Maximálně 2000 pixelů na nejdelší straně |
3 operace = 1 výstupní obrázek (nebo varianta) |
||
Obrazový model Firefly 4 Ultra: Více než 2000 pixelů na nejdelší straně |
4 operace = 1 výstupní obrázek (nebo varianta) |
||
| Vykreslování 3D objektů* | Vykreslujte produktové snímky v pixelově dokonalé kvalitě ve velkém měřítku automatizací tvorby fotorealistických snímků s přesným osvětlením, stíny a odrazy | Nejvýše 2000 pixelů na nejdelší straně | 1 operace = 1 výstupní obrázek |
Více než 2000 pixelů na nejdelší straně |
2 operace = 1 výstupní obrázek |
||
| Rozhraní API pro konverzi 3D souborů | Převeďte existující 3D obsah ve formátech jako FBX a OBJ do univerzálnějších formátů souborů, jako jsou gITF a USD | 1 operace = 1 výstupní soubor | |
| Rozhraní API pro vytváření 3D scén | Slučte více 3D objektů do soudržné a detailní scény navržené pro hostování digitálního dvojčete | 1 operace = 1 výstupní soubor | |
| Rozhraní API pro popis 3D scény | Generujte podrobné statistiky o obsahu 3D scény | Zdarma |
*Rozhraní API pro generování kompozice 3D objektů a rozhraní API pro vykreslování 3D objektů obsahují parametry, které umožňují generování více obrázků při každém volání rozhraní API.
Převody kreditů
| API operace | Generativní kredit |
|---|---|
| 1 API operace | 100 generativních kreditů* |
* Platí zlomkové převody; kredity jsou převáděny proporcionálně a nezaokrouhlují se nahoru na celou operaci.
Více informací o převodu kreditů souvisejících s poolingem generativních kreditů pro organizace najdete v článku Pool generativních kreditů.
