Úprava obrázkov
Otvorte Nastavenia → Dostupné pluginy, nainštalujte image-edit a potom ho nastavte v Nastavenia → Pluginy. V chate agent používa EditImage na zmenu existujúceho PNG alebo JPEG z aktuálneho projektu alebo z verejnej adresy URL podľa textového zadania. Každé volanie uloží 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}). Ak chcete obrázok vytvoriť iba z popisu, pozri Generovanie obrázkov.
Plugin nepridáva do webového rozhrania žiadny slash príkaz ani stránku. V Nastavenia → Pluginy má vlastnú kartu.
Nastavte poskytovateľa obrázkov
Administrátor pridá poskytovateľa kompatibilného s OpenAI alebo pripojí účet ChatGPT či OpenRouter v časti nastavení AI. Tá sa volá podľa mena asistenta, v predvolenom stave teda 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.
Upravte existujúci obrázok
EditImage vyžaduje instruction a k tomu buď file_path k PNG alebo JPEG v aktuálnom projekte, alebo verejnú url s HTTP(S). Zdroj zadajte práve jeden; volanie sa odmietne, keď zadáte oba alebo žiadny.
Napríklad nastavte file_path na assets/room.jpg a instruction na „odstráň neporiadok zo stola a natri stenu svetlomodro“. Namiesto toho môžete zadať verejnú adresu obrázka. Ak odpoveď z adresy nesie typ obsahu, musí ísť o PNG alebo JPEG; odpoveď bez neho sa považuje za PNG. Načítanie zdrojovej adresy má limit dvoch minút, sleduje najviac päť presmerovaní a odmietne obrázok väčší ako 10 MB.
Veľkosť výstupu volí obrazový model; rozlíšenie pre jednotlivé volania nastaviť nemožno. Úprava vytvára nové vykreslenie, nie presnú záplatu pixelov. V predvolenom nastavení zapíše jedinečný súbor do generated-images/ s príponou vráteného formátu: .png, .jpg alebo .webp, a zdroj nechá bez zmeny. Výsledkom je cesta k uloženému obrázku: jeho vytvorením sa obrázok automaticky neodošle. Ak chcete uložiť inde v projekte, použite output_path. 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úci súbor na výslednej ceste sa nahradí iba s overwrite: true a overwrite bez output_path sa odmietne. Ak výsledná cesta mieri na zdroj, môže ho nahradiť; iný výstupný formát zapíše inú cestu.
Inštalácia a prístup
Plugin image-edit 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, pretože jeho manifest neuvádza žiadne právomoci, ktoré by súhlas vyžadovali. 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
Úprava obrázka môže pred vypršaním limitu trvať až dve minúty. Chýbajúce zadanie úpravy sa odmietne skôr, než sa zavolá poskytovateľ. Zdrojový obrázok musí byť PNG alebo JPEG s veľkosťou najviac 10 MB, či už pochádza z projektu, alebo z adresy URL. Plugin vie načítať verejnú adresu obrázka, ale adresu v privátnej sieti použiť nemôže. Obrazové požiadavky idú cez Elowen, takže prihlasovacie údaje poskytovateľa zostávajú mimo plugin.
ShareImage zobrazí uložený obrázok v chate iba pri typoch súborov, ktoré prijíma, teda PNG, JPEG, GIF a WebP do 10 MiB. Za jeden ťah zdieľa najviac štyri obrázky. V neobmedzenej relácii s plným prístupom môže súbor podľa cesty zdieľať iba vlastník inštancie.
Referenčná príručka pre vývojárov
Referenčný opis implementácie opisuje zdieľané obrazové behové prostredie a kontrakt hostiteľa.