Úvod

AYETO API umožňuje vaší aplikaci dělat to, co uživatel dělá v aplikaci AYETO: chatovat s modely a asistenty, číst a spravovat konverzace, spouštět workflow, rozhodovat o schváleních ve workflow a pracovat s databázemi booster panelů. Každý požadavek se provádí jménem uživatele, kterému API klíč patří, s jeho oprávněními a kredity.

Základní URL #

Všechny endpointy leží pod jednou základní URL:

https://ayeto.ai/api/v3

Verze API je součástí cesty. Verze 3 je API pro integrace; ostatní cesty, na které můžete v aplikaci AYETO narazit (například /api/v1), jsou interní cesty aplikace a mohou se bez upozornění změnit.

Jak je API uspořádané #

• RPC přes POST. Téměř každý endpoint je POST s tělem v JSON a jmenuje se podle toho, co dělá: /conversation/find, /conversation/count, /workflow/run. Nejsou zde žádné routy GET /resource/{id} ani DELETE. Viz Požadavky.
• Autentizace API klíčem. Klíč posílejte v hlavičce uni-api-key. Každý klíč nese rozsahy (scopes), které určují, jaké endpointy smí volat. Viz Autentizace.
• Seznamy se dotazují jedním tvarem těla. Endpointy find a count přijímají filtry, řazení a stránkování v těle. Viz Dotazy na seznamy.
• Chyby jsou v JSON ve tvaru {"detail": "..."} se smysluplným HTTP stavem. Viz Chyby.
• Dlouhé odpovědi se streamují. Odpovědi chatu a běhy workflow lze streamovat průběžně, jak vznikají. Viz Streamování.

Rychlý start #

1. V aplikaci AYETO otevřete Profil → API klíče, vytvořte klíč s rozsahem AYETO chat a zkopírujte ho. Klíč se zobrazí jen jednou.

2. Uložte ho do proměnné prostředí:

   bash

   export AYETO_API_KEY="ayeto-..."
   

3. Položte modelu otázku:

   bash

   curl -X POST "https://ayeto.ai/api/v3/chat" \
     -H "uni-api-key: $AYETO_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"model": "gpt-5-mini", "message": "Summarize the benefits of unit tests in three bullet points."}'
   

   Odpověď přijde jako objekt zprávy; její content je v Markdownu. Chcete-li v konverzaci pokračovat, vygenerujte si sami UUID, pošlete ho jako conversation_id s první zprávou a znovu s každou další (viz Chat). Id modelů, které můžete použít, vrací /ai_model/get_all.

Co číst dál #