Zde jsou uvedeny změny, které se dotýkají klientů API, od nejnovějších. Uvádějí se i přírůstky, které nemění stávající chování (nové volitelné pole, nový endpoint), abyste viděli, co je nově k dispozici.
2026-11-21
- Nový endpoint
POST /api/v3/embeddings: embedding vektory pro dávku textů (modelysmallalarge, volitelnédimensions), s novým rozsahemayeto.embeddings. Stávající API klíče se všemi rozsahy (*) ho mohou používat hned; klíči s vybranými rozsahy je potřeba nový rozsah přidat. - Nový endpoint
POST /api/v3/data-loader/load-batch: převede několik souborů na text v jednom požadavku, souběžně, s výsledkem nebo chybou pro každý soubor. Minimální cena se uplatní jednou na dávku.
2026-11-18
- Text průběhu volání nástroje už nemůže uzavřít vlastní blok: před řádek textu, který zní
***, se vkládá mezera nulové šířky (U+200B), a to vcontenti v událostechtool_call_outputstreamu (Volání nástrojů v odpovědi). Dosud takový řádek klientům, kteří značky parsují, blok předčasně ukončil.
2026-11-05
- Když stream chatu skončí předčasně, výsledky už dokončených volání nástrojů v konverzaci zůstanou, takže je další zpráva nespouští znovu. Jako přerušená se modelu hlásí jen volání, která nedoběhla.
- Volání modelu přerušené odpojením se účtuje tak, že část promptu, kterou už poslalo předchozí volání v konverzaci, má cenu pro cachovaný vstup.
- Konverzace s voláním nástrojů po nové zprávě čtou víc historie z cache promptu, což u dlouhých konverzací snižuje cenu vstupu.
- Konverzace, jejichž starší zprávy byly automaticky zkompaktovány, dál čtou z cache promptu celou historii, takže jsou jejich volání modelu výrazně levnější.
2026-10-19
- Export workflow uvádí pracovní prostory, které kroky jmenují, i s názvy (
workflow.workspaces); import a kopie přijímajíworkspace_map, kterým je nahradí jinými pracovními prostory (Export a import). - Workflow pracují s pracovními prostory: nové typy uzlů
workspace.read,workspace.list,workspace.search,workspace.write,workspace.save_fileaworkspace.managea spouštěčtrigger.workspace, který spustí publikované workflow při změnách ve složce pracovního prostoru (Pracovní prostory). Spouštěče v informacích o nasazení nesouworkspace_idafolder. assistant.runpřijímáworkspaces: pracovní prostory, které asistent smí použít jen v daném kroku.- Workflow si drží hodnoty mezi běhy: typy uzlů
state.get/state.seta novéPOST /api/v3/workflow/state/list,/workflow/state/seta/workflow/state/delete(Uložené hodnoty). - Nové pole běhu
not_before: běh spouštěče pracovního prostoru ve frontě do té doby čeká. - Sdílení nesou
shared_by(id uživatele) ashared_at(časové razítko): kdo sdílení přidal a kdy. Nastavuje je server; hodnoty poslané vsharing/group_sharingse ignorují (objekt workflow). - Uživatel s přístupem ke sdílenému workflow jen pro čtení vidí jen své sdílení a skupiny, ve kterých je, ne ostatní příjemce.
- Uživatelé mohou v AYETU sdílení odmítnout, blokovat uživatele a sdílení nepřijímat. Příjemce, který vaše sdílení nepřijímá, se při vytvoření nebo úpravě sdílení vynechá; vrácený objekt ukazuje, co se uložilo.
- Nové pole jen pro čtení
sharing_declinedu workflow: uživatelé, kteří odmítli sdílení se skupinou.
2026-10-14
- Převod textu na řeč má nové modely a hlasy:
gpt-4o-mini-tts(doporučený) s 13 hlasy, mezi nimi novémarinacedar, a styl řeči podle pokynů.tts/mp3přijímá nová volitelná polemodel,styleainstructions;voicepřijme každý hlas zvoleného modelu (Převod textu na řeč). - Nový
POST /api/v3/tts/audio: řeč jakomp3,opus,aac,flacnebowav. - Nový
POST /api/v3/tts/voices: modely, jejich hlasy, předvolby stylu řeči a limit délky. - Výchozí hlas je
marin(dříveonyx), kde instalace používágpt-4o-mini-tts. - Jeden požadavek převede nejvýš 60 000 znaků (zhruba hodinu zvuku); delší
textdostane422. Prázdnýtextdostane422 The text is empty(dříve500 No audio generated), neznámý model nebo hlas422s důvodem. - Text se čte po částech z celých odstavců místo po větách a před vygenerováním řeči se zůstatek
porovná s odhadovanou cenou celého textu.
gpt-4o-mini-ttsse účtuje po tokenech, starší modely po znacích.
2026-10-08
- Stream chatu s
runner_version"2"opakuje statustool_call_pending, zatímco model píše argumenty volání nástroje, zhruba jednou za sekundu, sdata.arguments_chars(počet dosud napsaných znaků). Dlouhá volání nástrojů tak ukazují průběh místo jediné události. - Volání modelu přerušené tím, že klient zavřel spojení, se účtuje za část vygenerovanou do té doby.
2026-10-07
- Nové kroky workflow
booster.lockabooster.unlock: zámky záznamů a kolekcí booster databáze, které používají panely, s omezeným čekáním a vypršením. - Kroky workflow, které čtou soubory, přijímají soubory booster panelů, ke kterým má uživatel přístup (odkaz panelu nebo id), i v bězích spuštěných spouštěči.
- Booster panely s přihlášením účtem AYETO mohou volat API jménem přihlášeného člověka: token
relace funguje jako
uni-api-keys odsouhlasenými rozsahy (Autentizace). - Úložiště souborů boosteru: velké soubory lze nahrát přímo do úložné služby
(
upload/init,upload/complete), kde to instalace nabízí. - Nový spouštěč workflow
trigger.booster_file: spustí publikované workflow, když se v úložišti booster panelu uloží, změní nebo smaže soubor; soubor jeinput.file. Spouštěče workflow ho uvádějí s panelem a sledovanou složkou vcollection. - Novinka: úložiště souborů booster panelů. Panely mohou ukládat soubory do složek
s pravidly přístupu;
/booster/storage/private/*je nahrává (multipart nebo base64), vypisuje, dává k nim odkazy, přesouvá a maže, s novými scopyayeto.booster.storageaayeto.booster.storage.write. - Soubory na odkazech AYETA mají hlavičku
X-Content-Type-Options: nosniff; soubory SVG, HTML a XML se vždy stáhnou, prohlížeč je nezobrazí (v<img>se obrázky SVG zobrazují dál).
2026-10-06
- Katalog modelů (
/ai_model/get_all) vrací jen modely, které můžete použít: vypnuté (is_enabledfalse) ani vyřazené (is_deprecatedtrue) modely už v něm nejsou. - Katalog modelů (
/ai_model/get_all) má nové poleis_recommended: modely, které doporučují administrátoři. - Stream chatu s
runner_version"2"má novou fázi stavuconversation_named(data.name): nová konverzace dostane název podle první zprávy už během generování první odpovědi, ne až po ní. Když událost dorazí, název je uložený. findacountodmítajífiltersasort_keypodle interních polí uložených se záznamem (například tajností) s422; dřív se takové podmínky přijaly.
2026-10-05
- Konverzace mají dvě nová pole,
booster_panel_idapanel_user_id: konverzace přihlášených uživatelů vašich booster panelů s vašimi asistenty./conversation/findje vrací s ostatními vašimi konverzacemi (vynechá je filtr["panel_user_id", "==", null]);/chatu nich odpoví403, pokračuje v nich jen uživatel panelu. - Záznamy booster databáze mají nové pole
owner(UUID nebonull): uživatel panelu, který záznam vytvořil, u panelů s uživatelskými účty.findacountpřijímajíownerve filtrech i jakosort_key. Záznamy vytvořené přes API majíowner: null. Když se uživatelský účet panelu natrvalo smaže, smažou se i záznamy, které vytvořil. - Pravidla kolekcí mají dvě nové úrovně,
useraowner. Stejně jako ostatní úrovně kroměnonepovolují požadavky přes API, a to nad všemi záznamy. POST /ai_model/get_allmůže vracet modely nového typugoogle_video_gen(generování videa). Videa vygenerovaná v chatu jsou uvedena vattachmentsodpovědi, stejně jako vygenerované obrázky.- V chatu přes API se odmítají akce nástrojů, které aplikace AYETO nechává uživatele potvrdit v chatu (například založení booster panelu nebo workflow z chatu): volání nástroje skončí chybou a model pokračuje v odpovědi.
POST /ai_tool/get_allvrací dva další nástroje,BoosterStudioStartFunctionTool(založí booster panel ze šablony) aWorkflowStudioStartFunctionTool(založí workflow). Můžete je přidat svým asistentům; potřebují potvrzení uživatele v chatu aplikace AYETO, takže v chatu přes API se odmítnou, jak je popsáno výše.- Nově zdokumentováno:
POST /booster/panel/info, který vrací název panelu, jeho organizaci a uživatele klíče a ověří přístup k panelu. Samotný endpoint se nemění.
2026-10-04
- Nástroje vracené
POST /ai_tool/get_allmají nové polecompanion_of_groups(pole názvů skupin): jakocompanion_of_group, pro pomocný nástroj, který doprovází více skupin.
2026-10-03
- Nástroje z
POST /ai_tool/get_allmají dvě nová pole:vision(nástroj ukazuje modelu obrázky a nabízí se jen s modely, které obrázky vidí) aoutbound(nástroj umí poslat data mimo AYETO, například webové požadavky nebo e-mail). - Chybně utvořené dotazy na seznamy se odmítají s
422a srozumitelnýmdetailmísto500: podmínka, která nemá 3 ani 4 prvky, prvekfilters, který není pole ani objekt, objekt skupiny bez klíče nebo s několika klíči, skupinaAND/OR, jejíž hodnota není neprázdné pole, skupiny vnořené hlouběji než do 32 úrovní, zápornélimit_fromalimit_tonižší nežlimit_from. - Odpovědi
429omezovače požadavků mají tělo{"detail": "Too many requests"}jako všechny ostatní chyby (klíčreasonzmizel);Retry-Afterse nemění. - Na chybějící rozsah API klíče se všude odpovídá
401API key is invalid. - Endpointy
.../geta.../deletepřijímají id i v těle JSON{"id": "<uuid>"}; parametr dotazuentity_iddál funguje. Když chybí obojí, nebo jde o dvě různá id, vrací se422. Tělo, které jim posíláte, musí být JSON. - Nové
POST /user_credit/get_selfaPOST /version(GET dál funguje a sdílí limit požadavků);/versionmá limit požadavků úrovně static (1 200 požadavků za minutu). POST /ai_tool/get_alluž nevrací skryté ani zastaralé nástroje.- Nový
POST /conversation/count(rozsahayeto.conversation, stejné tělo jako/conversation/find). - Náklady konverzace (
POST /usage/cost/conversation) jsou součtem skutečně účtovaných kreditů, ne přepočtem podle aktuálních cen; zahrnují textové tokeny obrázkových modelů a už neselhávají s404u modelů, které byly mezitím odebrány. - Chat s modelem, který neumí streamovat, odpověď uloží a vrátí (dříve se odpověď modelu ztratila a požadavek vracel zprávu uživatele).
- Přílohy chatu se kontrolují a ukládají ještě před vším ostatním: příloha odmítnutá
s
422(file is too large, kvóta úložiště, neplatná data) už po sobě nenechává zprávu uživatele. Chybně utvořený base64 vrací422invalid base64 data in attachment '<filename>'(neboinvalid data URI in attachment '<filename>') místo500. Polesizeu příloh už není povinné a ignoruje se. - Navazující zpráva chatu ke konverzaci vytvořené v organizaci běží v této organizaci,
když požadavek žádnou organizaci neuvádí (účtuje se tam, vyžaduje se členství);
uvedení jiné organizace vrací
422the conversation belongs to another organization. Konverzace jiného uživatele se odmítne s403dřív, než se uloží jakákoli příloha. - Strukturovaný stream chatu (
runner_version"2") už neposílá nepoužívané poleiteration. - Booster databáze: vytvoření záznamu s klíčem, který už existuje, vrací
422a record with key '<key>' already existsmísto500;limit_frombezlimit_tovrací až 100 záznamů odlimit_from(limit_frommusí být menší než1000); chybně utvořené filtryAND/ORvracejí422místo500. - Data loader: nepodporované typy souborů vracejí
422unsupported file type '<mime>'a neúčtují se. - Workflow: soubor uvedený svým id ve vstupu běhu zůstává uživateli a už se nemaže spolu s během (soubory poslané jako base64 dál patří běhu).
2026-10-02
- Pravidla kolekcí booster databáze platí jen pro panely v režimu veřejné databáze; v soukromém režimu se ignorují. Uživatelé, se kterými je panel sdílen jen pro čtení, teď mohou zapisovat jeho záznamy a brát zámky (v obou režimech).
POST /tts/mp3vyžaduje nový rozsahayeto.ttsaPOST /data-loader/loadnový rozsahayeto.data_loader. Stávající API klíče dostaly oba rozsahy; klíče vytvořené spárováním desktopového klienta (jenayeto.connector) už tyto endpointy volat nemohou.POST /tts/mp3aPOST /data-loader/loadpřijímají volitelnéorganization_id: požadavek běží v organizaci a účtuje se z kreditu uživatele v ní (jen administrátoři a členové; hosté a nečlenové dostanou403).POST /tts/mp3vrací422snot enough user credit/not enough organization credit, když dojde kredit, místo500Failed to generate audio.- Chat odmítne model vypnutý administrátory (požadovaný přímo nebo jako model
asistenta) s
422model is disableda automatický model bez dostupného modelu s422model is not available;model is deprecatedse vrací dřív, než se na konverzaci sáhne. - Čtení konverzace jiného uživatele přes
/conversation/get(odmítnuté s404) už neaktualizuje její poleaccessed. - Hlavička
languagepožadavku API už nemění preferovaný jazyk uživatele v aplikaci AYETO (dříve ho každý požadavek uložil a požadavek bez hlavičky ho vrátil na angličtinu). POST /assistant/avatar/getpřijímá API klíče s novým rozsahemayeto.assistant, který lze nyní vybrat při vytváření klíče (pokrývá i/assistant/find).- Nová dokumentace API v3, která nahrazuje dřívější poznámky k betaverzi.
- Workflow jsou dostupná v API: čtení, spouštění, streamování běhů, schvalování,
úpravy, publikování, export a import (
ayeto.workflow,ayeto.workflow.write). - Soukromé API booster databáze s vlastními rozsahy (
ayeto.booster.database,ayeto.booster.database.write).