Integrace AI s vlastním klíčem BYOK

OpenAI podporuje generování obrázků, průhledné pozadí a funkci Vylepšit detaily pomocí AI. Google Gemini generuje ilustrace z promptu; v současné integraci nenabízí průhledné pozadí ani vylepšování detailů pomocí AI. Pozadí obrázku z Gemini můžete později odstranit nástroji Designeru.

Anthropic Claude slouží k práci s textem. V místním Designeru ve WordPressu může po vypnutí vrstvy Obrázek připravit sadu s textem, jednoduchými vektory a QR kódem. Nenahrazuje model pro generování rastrových ilustrací.

Níže najdete katalog modelů podporovaných současnou integrací. V pluginu WordPress vybíráte textový a obrazový model v Podrobnostech připojení. V aplikaci Alter Product vybíráte připojení a model určuje konfigurace služby - okno generátoru nemá samostatný výběr modelů.

Výchozí konfigurace OpenAI používá gpt-5.4-mini pro text a gpt-image-2.5-sunburst pro obrázky. U Gemini jde o gemini-3.5-flash-lite a gemini-3.1-flash-image. Možnost použít konkrétní model závisí také na jeho dostupnosti a oprávněních na vašem účtu API.

Otevřete Nastavení AI, vyberte poskytovatele a použití Generování grafiky a poté přidejte klíč API. Volitelný název pomáhá rozlišit připojení, například firemní účet od účtu pro zkoušení nápadů. Potvrďte informace o nákladech a vyberte Přidat klíč.

Pokud máte více aktivních připojení, generátor umožňuje vybrat je podle názvu. V nastavení můžete také určit výchozí připojení, změnit název nebo klíč, připojení vypnout či odstranit. Pro vytvoření sady vrstev s obrázkem nemusíte přidávat samostatný klíč pro prompty.

Uložení připojení nespouští generování. Klíč se na serveru ukládá zašifrovaný; rozhraní zobrazuje pouze jeho konec. Odstranění připojení z Alter Product nezneplatní klíč na účtu poskytovatele.

Napište, co má grafika znázorňovat, jak mají být prvky rozmístěny a jaké barvy mají převládat. Pro potisk je vhodné upřesnit, že má být vidět celý motiv, kolem něj má být volné místo a zda má obsahovat nápisy. Pole promptu pojme až 500 znaků.

Můžete začít příkladem pod polem promptu a upravit jej pro svůj produkt. Pokud chcete konkrétní nápis, uveďte jeho znění v uvozovkách a zapněte vrstvu Text. Vybraný styl by měl odpovídat popisu - nastavení stylu má přednost před protichůdným pokynem v promptu.

Rozbalte Vrstvy a označte pouze potřebné prvky. Zpočátku jsou aktivní Obrázek a Text. Pro samostatnou ilustraci ponechte jen Obrázek. Pokud chcete kompozici pro další úpravy, přidejte ostatní typy vrstev.

Nápisy v obrázku a vrstva Text poskytují odlišné výsledky. První možnost povoluje písmena uvnitř bitmapy. Druhá vytváří samostatné nápisy, které můžete později měnit textovými nástroji. Pro slogan, který chcete upravovat, zvolte vrstvu Text.

Po zapnutí QR kódu zadejte obsah nebo adresu URL do příslušného pole. Nenahrazujte jej popisem vzhledu kódu v promptu. Po vložení ověřte obsah a čitelnost kódu v cílovém návrhu.

Vyberte formát Čtverec, Na výšku nebo Na šířku s poměrem stran 1:1, 2:3 nebo 3:2. Přizpůsobte jej tvaru potisku: svislý motiv na přední stranu trička, vodorovnou kompozici na široký produkt nebo čtverec pro univerzální grafiku.

Na výběr máte 31 připravených stylů a styl Vlastní, ve kterém zadáte vlastní popis do 500 znaků. Jednotný charakter kolekce můžete vytvářet používáním stejného stylu a podobné palety v dalších promptech.

Pozadí může vycházet z promptu, mít vybranou barvu nebo být průhledné. Pokud potřebujete jen samotný motiv pro potisk, zvolte průhlednost v nastavení. V současné integraci tato možnost vyžaduje OpenAI; pro Gemini vyberte pozadí z promptu nebo barvu. Výsledek si před použitím vždy prohlédněte.

Následující popisy berte jako výchozí bod. Styl, pozadí a vrstvy nastavte ve formuláři a v promptu se zaměřte na motiv a kompozici. Tyto příklady nezaručují stejný výsledek při každém generování.

Kliknutím na miniaturu zobrazíte větší náhled. V nabídce výsledku najdete Kopírovat prompt a Vygenerovat znovu. Zkopírování umožňuje vrátit se k popisu a před dalším generováním změnit například paletu, téma nebo nápis.

Vygenerovat znovu připraví nový výsledek z uložených nastavení. Použije původní připojení a aktuální klíč, takže připojení musí být stále dostupné. Jde o další požadavek poskytovateli, který může být zpoplatněn, nikoli o stažení kopie předchozího obrázku.

U neúplného výsledku zkontrolujte hlášení a přítomné vrstvy. Dostupné prvky můžete použít, ale před uložením ověřte nápisy, QR, pozadí a úplnost kompozice. Historie umožňuje prohlížet a vkládat uchované sady i po vypnutí klíče.

Zvětšit obrázek připraví větší verzi bitmapy bez nového volání poskytovatele AI. V současné implementaci se delší strana zvětší na dvojnásobek, nejvýše na 4096 px. Funkce se týká výsledků obsahujících obrázek.

Pro práci na scéně může zůstat menší náhled, zatímco větší soubor se použije při tisku. Samostatný text, vektory a uspořádání vrstev zůstávají beze změny. Pokud je výsledek již v návrhu, lze k němu připojit větší tiskový soubor.

Vyšší počet pixelů nezaručuje obnovení jemných detailů originálu ani správný tisk v libovolné velikosti. Zkontrolujte obrázek v cílových rozměrech potisku a nastavte parametry exportu ve Správci tisku.

U podporovaného výsledku OpenAI vyberte Vylepšit detaily pomocí AI. Zadejte Popis změn, například „zpřesni obrysy srsti, zachovej kompozici a barvy“, a spusťte vylepšení. Pole pojme až 2000 znaků. Obrázek a pokyn se odešlou poskytovateli AI.

Operace vyžaduje aktivní původní připojení, dostupný model a výsledek s jediným obrázkem. V aplikaci další úprava vychází z poslední dokončené revize. V současné verzi pluginu WordPress používá vylepšení z karty historie původní obrázek. Samostatné textové a vektorové vrstvy nejsou součástí upravované bitmapy.

Vylepšení pomocí AI může změnit vzhled a být znovu zpoplatněno. Prohlédněte si nový výsledek a poté jej vyberte do návrhu. Vizuální změna automaticky nenahradí grafiku již umístěnou na scéně.

Na kartě výsledku použijte Vybrat. Okno generátoru se zavře a vy určíte místo v tiskové oblasti. Miniaturu nebo náhled můžete také přetáhnout na scénu. Potřebujete otevřený návrh a připravenou tiskovou oblast.

Sada se vloží do návrhu jako skupina vrstev. Text, jednoduché vektory a QR kód můžete nadále upravovat; vygenerovaná ilustrace zůstává obrázkem. Upravte polohu a měřítko ve 2D a umístění potisku ověřte na 3D modelu.

Po přidání grafiky můžete používat stávající nástroje: odstranění pozadí, maskování, filtry, polotóny, vektorizaci a opakování vzoru. Jde o fázi úprav v Designeru, dostupnou nezávisle na samotném generování.

Po doladění uložte návrh běžným tlačítkem Designeru. Pokud chcete kompozici znovu použít, zvolte Uložit jako novou šablonu (knihovna) v příslušném okně ukládání. Historie generování slouží k výběru výsledků a knihovna k uchovávání zdrojů pro opakované použití.

Ve WordPressu použijte uložený návrh nebo šablonu v místních produktech obchodu. Zákazník může sdílenou kompozici personalizovat v Customizeru pomocí předem připravených prvků. Samotné vygenerování obrázku jej automaticky nezveřejní v knihovně ani v nabídce obchodu.

Přejděte do Alter Product → Nastavení → Integrace AI a vyberte Přidat poskytovatele. Zvolte OpenAI, Google Gemini nebo Anthropic Claude. V Podrobnostech připojení vyberte modely, které chcete používat.

Přímé připojení ukládá samostatný klíč v pluginu, zašifrovaný pomocí klíčů instalace WordPress. Případně můžete použít WordPress AI Client a sdílený konektor nastavený v Nastavení → Connectors. Tato varianta vyžaduje WordPress 7.0 nebo novější a dostupný konektor poskytovatele.

Uložte připojení, nastavte limity, zaškrtněte Zapnout AI s mými účty poskytovatelů a klikněte na Uložit nastavení AI. V otevřeném okně si přečtěte informace o nákladech, zpracování obsahu a kontrole výsledků, zaškrtněte souhlas a potvrďte uložení. Samotné přidání připojení generování nezapne.

U OpenAI a Gemini obsahuje připojení pro obrázky také textový model používaný k přípravě kompozice. V podrobnostech vyberte oba modely. Claude podporuje práci s textem; pro použití v místním generátoru vypněte Obrázek a vyberte potřebné vrstvy textu, jednoduchých vektorů nebo QR.

V pluginu je kvalita obrázků OpenAI ve výchozím nastavení omezena na Low a lze ji změnit v limitech využití. Integrace Gemini používá rozlišení 1K; limit kvality OpenAI se na ni nevztahuje. Nastavení a způsob přípravy kompozice se liší od služby v aplikaci, takže stejný prompt neznamená v obou prostředích totožný výsledek.

Otevřete místní návrh produktu přes Product Designer v pluginu nebo pomocí akce Designeru u produktu WooCommerce. Spusťte v něm Generátor AI, připravte výsledek a přidejte jej do návrhu stejně jako v dříve popsaném postupu.

Generování vyžaduje správce s oprávněním spravovat nastavení WordPressu. Veřejný Customizer, Configurator a Viewer nespouštějí generování AI s klíčem obchodu. Mohou však zobrazovat a používat dříve uloženou grafiku v připravených produktech.

Po uložení návrhu nebo šablony se potřebná grafika zkopíruje do místních zdrojů WordPressu. Odstranění záznamu historie AI neodstraní samostatné soubory již uložené v návrhu. Šablony dále spravujete v Assets; na kartě zdrojů nejde o samostatný generátor AI.

Generování, opakované generování a vylepšování detailů pomocí AI používají API poskytovatele. Jeden příkaz v rozhraní může zahrnovat více požadavků, například přípravu kompozice a vygenerování obrázku. Náhled, vložení uchovaného výsledku a běžné zvětšování nespouštějí nové generování u poskytovatele.

V pluginu je výchozí denní limit 20 pokusů o požadavek a je společný pro správce webu. U běžné sady s obrázkem spotřebuje plánování a obrázek obvykle dva pokusy; samotný text jeden. Započítávat se mohou i neúspěšné pokusy. Počítadlo se obnovuje o půlnoci UTC.

Limit pokusů není peněžní rozpočet. Nastavte také výdajové limity dostupné na účtu poskytovatele a kontrolujte jeho vyúčtování. Zrušení úlohy nevrátí poplatek za již provedené volání. V aplikaci platí limity služby a poskytovatele; nejde o stejné počítadlo jako limit vašeho pluginu.

Hotové materiály uchovávejte v návrzích nebo šablonách a nespoléhejte jen na historii AI. Před předáním do výroby zkontrolujte nápisy, ostrost, průhlednost, velikost a čitelnost QR kódu. Poté přejděte k tiskovým oblastem a Správci tisku.

V pluginu mají přímé připojení a sdílený konektor WordPress samostatná nastavení klíčů. Změna způsobu připojení mezi nimi automaticky nepřenáší tajný klíč. Přímé klíče a soukromá historie AI jsou vázány na šifrovací klíče instalace, proto je uchovávejte spolu s bezpečnou zálohou databáze a souborů WordPressu.