Generovanie obrázkov
Otvorte Nastavenia → Dostupné pluginy, nainštalujte image-gen a potom ho nastavte v Nastavenia → Pluginy. V chate agent používa GenerateImage na vytvorenie obrázka z textového popisu. Každé volanie uloží jeden nový obrázok PNG, JPEG alebo WebP do aktuálneho projektu do priečinka generated-images/ a vráti jeho cestu; oprávnený odosielateľ ho môže zobraziť v chate pomocou ShareImage({file_path}). V neobmedzenej relácii s plným prístupom môže súbor podľa cesty zdieľať iba vlastník inštancie. Ak chcete zmeniť existujúci obrázok, pozri Úprava obrázkov.
Ani jeden z pluginov nepridáva do webového rozhrania slash príkaz ani stránku. Každý má v Nastavenia → Pluginy vlastnú kartu.
Nastavte poskytovateľa obrázkov
Administrátor pridá poskytovateľa kompatibilného s OpenAI alebo pripojí účet ChatGPT či OpenRouter v Nastavenia → Elowen AI. Potom otvorte nastavenia pluginu v Nastavenia → Pluginy a vyberte jeho poskytovateľa. Poskytovateľ kompatibilný s OpenAI použije svoj nastavený API kľúč a základnú adresu URL; pripojené účty využívajú obrazovú službu hostiteľa. ID modelov OpenRouter si zachovávajú menný priestor výrobcu, napríklad google/gemini-2.5-flash-image.
Nastavenie Model vyberá jeden z obrazových modelov daného poskytovateľa, ktoré smie váš účet používať (administrátor ich povoľuje v Povolené modely na stránke Používatelia); nechajte ho prázdne, ak chcete použiť predvolený model poskytovateľa. Pri pripojenom účte ChatGPT je predvolený gpt-image-2.5-sunburst; pri inom poskytovateľovi, vrátane poskytovateľa s API kľúčom kompatibilného s OpenAI a OpenRoutera, sa prázdne pole vracia k gpt-image-1. Pre OpenRouter vyberte obrazový model výslovne. Kým nie je nastavený použiteľný poskytovateľ, nástroj nie je dostupný; bez neho sa agentovi obrazový nástroj neponúkne.
Veľkosť výstupu volí obrazový model. Nastavenie veľkosti ani rozlíšenia pre jednotlivé volania neexistuje.
Vygenerujte nový obrázok
Zadajte tému, štýl, kompozíciu a farby. GenerateImage prijíma povinný prompt a voliteľné file_path a overwrite.
Napríklad požiadajte o „ploché modré logo sovy na bielom pozadí, vycentrované, s jednoduchými geometrickými tvarmi“. Keď pomenujete tému, štýl, rozvrhnutie aj farby, dostane model užitočné vedenie. Text v generovaných obrázkoch môže byť nespoľahlivý.
Výsledkom je cesta k uloženému obrázku, nie obrázkové dáta priamo v odpovedi: vytvorením sa obrázok automaticky neodošle. Predvolený názov súboru je jedinečný a má príponu vráteného formátu: .png, .jpg alebo .webp. Pomocou file_path uložíte obrázok inde v projekte, a to relatívne k pracovnému adresáru alebo absolútne v prostredí projektu. Cesta musí končiť na .png, .jpg, .jpeg alebo .webp; nezodpovedajúca prípona sa upraví na vrátený formát a nástroj oznámi skutočnú cestu. Zodpovedajúca prípona zostane zachovaná. Existujúce súbory na výslednej ceste sa nikdy nenahradia, ak zároveň nenastavíte overwrite: true; overwrite: true bez file_path sa odmietne. Ak chcete zmeniť existujúci obrázok, použite EditImage z pluginu Úprava obrázkov.
Inštalácia a prístup
Plugin image-gen nainštalujte v Nastavenia → Dostupné pluginy. Požadované vydanie jadra overte v manifeste pluginu a v katalógu: plugin vyžaduje jadro 0.30.4 a shared API 14, teda dvojicu, ktorá prináša zdieľané obrazové behové prostredie a kontrakt obrazovej služby hostiteľa. Poskytovateľa nastavte podľa vyššie uvedeného postupu. Plugin nemožno prideľovať jednotlivým používateľom, takže po nastavení poskytovateľa môže jeho nástroj použiť každý prihlásený účet. Naďalej ho obmedzujú oprávnenia účtu k nástrojom.
Zapnutie pluginu nevyžaduje potvrdenie súhlasu. Zapnutie, vypnutie, uloženie nastavení aj odinštalovanie reštartujú Elowen. Obrazovka nastavení potom zobrazí „Zmena je uložená. Elowen sa teraz reštartuje, aby ju načítala.“ Reštart prebehne, hneď ako niekoľko sekúnd nepríde žiadna ďalšia požiadavka.
Obmedzenia
Generovanie obrázka môže pred vypršaním limitu trvať až dve minúty. Chýbajúci prompt sa odmietne skôr, než sa zavolá poskytovateľ. Obrazové požiadavky idú cez Elowen, takže prihlasovacie údaje poskytovateľa zostávajú mimo plugin.
Referenčná príručka pre vývojárov
Referenčný opis implementácie opisuje zdieľané obrazové behové prostredie a kontrakt hostiteľa.