Generování obrázků
Otevřete Nastavení → Dostupné pluginy, nainstalujte image-gen a potom ho nastavte v Nastavení → Pluginy. V chatu agent používá GenerateImage k vytvoření obrázku z textového popisu. Každé volání uloží jeden nový obrázek PNG, JPEG nebo WebP do aktuálního projektu do složky generated-images/ a vrátí jeho cestu; oprávněný odesílatel ho může zobrazit v chatu pomocí ShareImage({file_path}). V neomezené relaci s plným přístupem může soubor podle cesty sdílet jen vlastník instance. Pokud chcete změnit existující obrázek, viz Úprava obrázků.
Ani jeden z pluginů nepřidává do webového rozhraní slash příkaz ani stránku. Každý má v Nastavení → Pluginy vlastní kartu.
Nastavte poskytovatele obrázků
Administrátor přidá poskytovatele kompatibilního s OpenAI nebo připojí účet ChatGPT či OpenRouter v Nastavení → Elowen AI. Potom otevřete nastavení pluginu v Nastavení → Pluginy a vyberte jeho poskytovatele. Poskytovatel kompatibilní s OpenAI použije svůj nastavený API klíč a základní adresu URL; připojené účty využívají obrazovou službu hostitele. ID modelů OpenRouter si zachovávají jmenný prostor výrobce, například google/gemini-2.5-flash-image.
Nastavení Model vybírá jeden z obrazových modelů daného poskytovatele, které smí váš účet používat (administrátor je povoluje v Povolené modely na stránce Uživatelé); nechte ho prázdné, chcete-li použít výchozí model poskytovatele. U připojeného účtu ChatGPT je výchozí gpt-image-2.5-sunburst; u jiného poskytovatele, včetně poskytovatele s API klíčem kompatibilního s OpenAI a OpenRouteru, se prázdné pole vrací k gpt-image-1. Pro OpenRouter vyberte obrazový model výslovně. Dokud není nastavený použitelný poskytovatel, nástroj není dostupný; bez něj se agentovi obrazový nástroj nenabídne.
Velikost výstupu volí obrazový model. Nastavení velikosti ani rozlišení pro jednotlivá volání neexistuje.
Vygenerujte nový obrázek
Zadejte téma, styl, kompozici a barvy. GenerateImage přijímá povinný prompt a volitelné file_path a overwrite.
Například požádejte o „ploché modré logo sovy na bílém pozadí, vycentrované, s jednoduchými geometrickými tvary“. Když pojmenujete téma, styl, rozvržení i barvy, dostane model užitečné vedení. Text uvnitř generovaných obrázků může být nespolehlivý.
Výsledkem je cesta k uloženému obrázku, ne obrázková data přímo v odpovědi: vytvořením se obrázek automaticky neodešle. Výchozí název souboru je jedinečný a má příponu vráceného formátu: .png, .jpg nebo .webp. Pomocí file_path uložíte obrázek jinam v projektu, a to relativně k pracovnímu adresáři nebo absolutně v prostředí projektu. Cesta musí končit na .png, .jpg, .jpeg nebo .webp; neodpovídající přípona se upraví na vrácený formát a nástroj oznámí skutečnou cestu. Odpovídající přípona zůstane zachovaná. Existující soubory na výsledné cestě se nikdy nenahradí, pokud zároveň nenastavíte overwrite: true; overwrite: true bez file_path se odmítne. Pokud chcete změnit existující obrázek, použijte EditImage z pluginu Úprava obrázků.
Instalace a přístup
Plugin image-gen nainstalujte v Nastavení → Dostupné pluginy. Požadované vydání jádra ověřte v manifestu pluginu a v katalogu: plugin vyžaduje jádro 0.30.4 a shared API 14, tedy dvojici, která přináší sdílené obrazové běhové prostředí a kontrakt obrazové služby hostitele. Poskytovatele nastavte podle výše uvedeného postupu. Plugin nelze udělovat jednotlivým uživatelům, takže po nastavení poskytovatele může jeho nástroj použít každý přihlášený účet. Nadále ho omezují oprávnění účtu k nástrojům.
Zapnutí pluginu nevyžaduje potvrzení souhlasu. Zapnutí, vypnutí, uložení nastavení i odinstalování restartují Elowen. Obrazovka nastavení potom zobrazí „Změna je uložená. Elowen se teď restartuje, aby ji načetla.“ Restart proběhne, jakmile několik sekund nepřijde žádný další požadavek.
Omezení
Generování obrázku může před vypršením limitu trvat až dvě minuty. Chybějící prompt se odmítne dřív, než se zavolá poskytovatel. Obrazové požadavky jdou přes Elowen, takže přihlašovací údaje poskytovatele zůstávají mimo plugin.
Referenční příručka pro vývojáře
Referenční popis implementace popisuje sdílené obrazové běhové prostředí a kontrakt hostitele.