# Úvod

> Co AYETO API nabízí, jak je uspořádané a jak odeslat první požadavek.

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:

```text
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](conventions.md#pozadavky).
- **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](authentication.md).
- **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](conventions.md#dotazy-na-seznamy).
- **Chyby jsou v JSON** ve tvaru `{"detail": "..."}` se smysluplným HTTP stavem.
  Viz [Chyby](conventions.md#chyby).
- **Dlouhé odpovědi se streamují.** Odpovědi chatu a běhy workflow lze streamovat
  průběžně, jak vznikají. Viz [Streamování](streaming.md).

## 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](chat.md)).
   Id modelů, které můžete použít, vrací [`/ai_model/get_all`](models-and-tools.md).

## Co číst dál

| Stránka | Co popisuje |
|---|---|
| [Autentizace](authentication.md) | API klíče, rozsahy, chyby autentizace |
| [Konvence](conventions.md) | Tvar požadavku, společná pole, filtry, stránkování, chyby, limity požadavků |
| [Streamování](streaming.md) | Čtení streamovaných odpovědí chatu |
| [Chat](chat.md) | Posílání zpráv modelům a asistentům |
| [Konverzace](conversations.md) | Výpis, čtení a mazání konverzací |
| [Asistenti](assistants.md) | Výpis asistentů a jejich avatarů |
| [Modely a nástroje](models-and-tools.md) | AI modely a nástroje dostupné uživateli klíče |
| [Workflow](workflows.md) | Spouštění, úpravy a publikování workflow, schvalování, webhooky |
| [Booster databáze](booster-database.md) | Záznamy v databázích booster panelů |
| [Účet](account.md) | Kredity, členství v organizacích, náklady na využití, verze API |
| [Soubory a média](files-and-media.md) | Extrakce textu ze souborů, převod textu na řeč |
| [Changelog](changelog.md) | Změny API |