Reference

Changelog

Významné změny AYETO API.

Zobrazit jako Markdown

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ů (modely small a large, volitelné dimensions), s novým rozsahem ayeto.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 v content i v událostech tool_call_output streamu (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_file a workspace.manage a 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í nesou workspace_id a folder.
  • assistant.run př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.set a nové POST /api/v3/workflow/state/list, /workflow/state/set a /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) a shared_at (časové razítko): kdo sdílení přidal a kdy. Nastavuje je server; hodnoty poslané v sharing / group_sharing se 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_declined u 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é marin a cedar, a styl řeči podle pokynů. tts/mp3 přijímá nová volitelná pole model, style a instructions; voice přijme každý hlas zvoleného modelu (Převod textu na řeč).
  • Nový POST /api/v3/tts/audio: řeč jako mp3, opus, aac, flac nebo wav.
  • Nový POST /api/v3/tts/voices: modely, jejich hlasy, předvolby stylu řeči a limit délky.
  • Výchozí hlas je marin (dříve onyx), kde instalace používá gpt-4o-mini-tts.
  • Jeden požadavek převede nejvýš 60 000 znaků (zhruba hodinu zvuku); delší text dostane 422. Prázdný text dostane 422 The text is empty (dříve 500 No audio generated), neznámý model nebo hlas 422 s 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-tts se účtuje po tokenech, starší modely po znacích.

2026-10-08

  • Stream chatu s runner_version "2" opakuje status tool_call_pending, zatímco model píše argumenty volání nástroje, zhruba jednou za sekundu, s data.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.lock a booster.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-key s 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 je input.file. Spouštěče workflow ho uvádějí s panelem a sledovanou složkou v collection.
  • 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 scopy ayeto.booster.storage a ayeto.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_enabled false) ani vyřazené (is_deprecated true) modely už v něm nejsou.
  • Katalog modelů (/ai_model/get_all) má nové pole is_recommended: modely, které doporučují administrátoři.
  • Stream chatu s runner_version "2" má novou fázi stavu conversation_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ý.
  • find a count odmítají filters a sort_key podle interních polí uložených se záznamem (například tajností) s 422; dřív se takové podmínky přijaly.

2026-10-05

  • Konverzace mají dvě nová pole, booster_panel_id a panel_user_id: konverzace přihlášených uživatelů vašich booster panelů s vašimi asistenty. /conversation/find je vrací s ostatními vašimi konverzacemi (vynechá je filtr ["panel_user_id", "==", null]); /chat u nich odpoví 403, pokračuje v nich jen uživatel panelu.
  • Záznamy booster databáze mají nové pole owner (UUID nebo null): uživatel panelu, který záznam vytvořil, u panelů s uživatelskými účty. find a count přijímají owner ve filtrech i jako sort_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ě, user a owner. Stejně jako ostatní úrovně kromě none povolují požadavky přes API, a to nad všemi záznamy.
  • POST /ai_model/get_all může vracet modely nového typu google_video_gen (generování videa). Videa vygenerovaná v chatu jsou uvedena v attachments odpově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_all vrací dva další nástroje, BoosterStudioStartFunctionTool (založí booster panel ze šablony) a WorkflowStudioStartFunctionTool (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_all mají nové pole companion_of_groups (pole názvů skupin): jako companion_of_group, pro pomocný nástroj, který doprovází více skupin.

2026-10-03

  • Nástroje z POST /ai_tool/get_all mají dvě nová pole: vision (nástroj ukazuje modelu obrázky a nabízí se jen s modely, které obrázky vidí) a outbound (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 422 a srozumitelným detail místo 500: podmínka, která nemá 3 ani 4 prvky, prvek filters, který není pole ani objekt, objekt skupiny bez klíče nebo s několika klíči, skupina AND / OR, jejíž hodnota není neprázdné pole, skupiny vnořené hlouběji než do 32 úrovní, záporné limit_from a limit_to nižší než limit_from.
  • Odpovědi 429 omezovače požadavků mají tělo {"detail": "Too many requests"} jako všechny ostatní chyby (klíč reason zmizel); Retry-After se nemění.
  • Na chybějící rozsah API klíče se všude odpovídá 401 API key is invalid.
  • Endpointy .../get a .../delete přijímají id i v těle JSON {"id": "<uuid>"}; parametr dotazu entity_id dál funguje. Když chybí obojí, nebo jde o dvě různá id, vrací se 422. Tělo, které jim posíláte, musí být JSON.
  • Nové POST /user_credit/get_self a POST /version (GET dál funguje a sdílí limit požadavků); /version má limit požadavků úrovně static (1 200 požadavků za minutu).
  • POST /ai_tool/get_all už nevrací skryté ani zastaralé nástroje.
  • Nový POST /conversation/count (rozsah ayeto.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í s 404 u 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í 422 invalid base64 data in attachment '<filename>' (nebo invalid data URI in attachment '<filename>') místo 500. Pole size u 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í 422 the conversation belongs to another organization. Konverzace jiného uživatele se odmítne s 403 dřív, než se uloží jakákoli příloha.
  • Strukturovaný stream chatu (runner_version "2") už neposílá nepoužívané pole iteration.
  • Booster databáze: vytvoření záznamu s klíčem, který už existuje, vrací 422 a record with key '<key>' already exists místo 500; limit_from bez limit_to vrací až 100 záznamů od limit_from (limit_from musí být menší než 1000); chybně utvořené filtry AND / OR vracejí 422 místo 500.
  • Data loader: nepodporované typy souborů vracejí 422 unsupported 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/mp3 vyžaduje nový rozsah ayeto.tts a POST /data-loader/load nový rozsah ayeto.data_loader. Stávající API klíče dostaly oba rozsahy; klíče vytvořené spárováním desktopového klienta (jen ayeto.connector) už tyto endpointy volat nemohou.
  • POST /tts/mp3 a POST /data-loader/load př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é dostanou 403).
  • POST /tts/mp3 vrací 422 s not enough user credit / not enough organization credit, když dojde kredit, místo 500 Failed to generate audio.
  • Chat odmítne model vypnutý administrátory (požadovaný přímo nebo jako model asistenta) s 422 model is disabled a automatický model bez dostupného modelu s 422 model is not available; model is deprecated se vrací dřív, než se na konverzaci sáhne.
  • Čtení konverzace jiného uživatele přes /conversation/get (odmítnuté s 404) už neaktualizuje její pole accessed.
  • Hlavička language pož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/get přijímá API klíče s novým rozsahem ayeto.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).