Úprava obrázků
Otevřete Nastavení → Dostupné pluginy, nainstalujte image-edit a potom ho nastavte v Nastavení → Pluginy. V chatu agent používá EditImage ke změně existujícího PNG nebo JPEG z aktuálního projektu nebo z veřejné adresy URL podle textového zadání. Každé volání uloží 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}). Pokud chcete obrázek vytvořit jen z popisu, viz Generování obrázků.
Plugin nepřidává do webového rozhraní žádný slash příkaz ani stránku. V Nastavení → Pluginy má vlastní kartu.
Nastavte poskytovatele obrázků
Administrátor přidá poskytovatele kompatibilního s OpenAI nebo připojí účet ChatGPT či OpenRouter v části nastavení AI. Ta se jmenuje podle jména asistenta, ve výchozím stavu tedy 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.
Upravte existující obrázek
EditImage vyžaduje instruction a k tomu buď file_path k PNG nebo JPEG v aktuálním projektu, nebo veřejnou url s HTTP(S). Zdroj zadejte právě jeden; volání se odmítne, když zadáte oba nebo žádný.
Například nastavte file_path na assets/room.jpg a instruction na „odstraň nepořádek ze stolu a natři zeď světle modře“. Místo toho můžete zadat veřejnou adresu obrázku. Pokud odpověď z adresy nese typ obsahu, musí jít o PNG nebo JPEG; odpověď bez něj se považuje za PNG. Načtení zdrojové adresy má limit dvou minut, sleduje nejvýše pět přesměrování a odmítne obrázek větší než 10 MB.
Velikost výstupu volí obrazový model; rozlišení pro jednotlivá volání nastavit nelze. Úprava vytváří nové vykreslení, ne přesnou záplatu pixelů. Ve výchozím nastavení zapíše jedinečný soubor do generated-images/ s příponou vráceného formátu: .png, .jpg nebo .webp, a zdroj nechá beze změny. Výsledkem je cesta k uloženému obrázku: jeho vytvořením se obrázek automaticky neodešle. Chcete-li uložit jinam v projektu, použijte output_path. 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í soubor na výsledné cestě se nahradí jen s overwrite: true a overwrite bez output_path se odmítne. Pokud výsledná cesta míří na zdroj, může ho nahradit; jiný výstupní formát zapíše jinou cestu.
Instalace a přístup
Plugin image-edit 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, protože jeho manifest neuvádí žádné pravomoci, které by souhlas vyžadovaly. 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í
Úprava obrázku může před vypršením limitu trvat až dvě minuty. Chybějící zadání úpravy se odmítne dřív, než se zavolá poskytovatel. Zdrojový obrázek musí být PNG nebo JPEG o velikosti nejvýše 10 MB, ať pochází z projektu, nebo z adresy URL. Plugin umí načíst veřejnou adresu obrázku, ale adresu v privátní síti použít nemůže. Obrazové požadavky jdou přes Elowen, takže přihlašovací údaje poskytovatele zůstávají mimo plugin.
ShareImage zobrazí uložený obrázek v chatu jen u typů souborů, které přijímá, tedy PNG, JPEG, GIF a WebP do 10 MiB. Za jeden tah sdílí nejvýše čtyři obrázky. V neomezené relaci s plným přístupem může soubor podle cesty sdílet jen vlastník instance.
Referenční příručka pro vývojáře
Referenční popis implementace popisuje sdílené obrazové běhové prostředí a kontrakt hostitele.