Modely a nástroje

Katalog modelů a katalog nástrojů jsou stejné pro všechny uživatele serveru. Použijte je k nalezení model_id, které pošlete do chatu nebo nastavíte asistentovi, a hodnot name nástrojů, na které odkazuje seznam nástrojů asistenta.

Oba endpointy vracejí celý katalog v jedné odpovědi; stránkování neexistuje.

Výpis modelů #

Vrací AI modely, které server zná, volitelně jen modely jednoho typu. Seznam není přizpůsobený: každý uživatel dostane stejný katalog bez ohledu na organizaci.

Seznam obsahuje i modely, které administrátoři vypnuli (is_enabled false) nebo vyřadili (is_deprecated true). Chat odmítne obojí (422 model is disabled / model is deprecated, viz Chat); vybírejte modely s is_enabled true a is_deprecated false. Seznam není seřazený v žádném zaručeném pořadí.

Konkrétní ceny se nezveřejňují. Pro relativní představu o ceně použijte price_tier a pro to, kolik konverzace skutečně stála, náklady konverzace.

Požadavek #

Tělo je povinné; pro modely všech typů pošlete {}.

Odpověď #

200 OK s polem modelů.

Chyby #

Chyby autentizace, limitů požadavků a serveru jsou popsány v konvencích.

Příklad #

curl -X POST "https://ayeto.ai/api/v3/ai_model/get_all" \
  -H "uni-api-key: $AYETO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_type": "llm"}'

[
  {
    "id": "3f2a6c1e-8b4d-4e2a-9c7f-1d5e8a2b4c6d",
    "model_id": "example-chat-large",
    "model_type": "llm",
    "provider": "openai_responses",
    "display_name": "Example Chat Large",
    "description": "General purpose model for complex tasks.",
    "multilang_description": {
      "CZ": "Univerzální model pro složité úlohy.",
      "EN": "General purpose model for complex tasks."
    },
    "max_tokens": 32000,
    "max_reasoning_tokens": 0,
    "capabilities": ["chat", "stream", "assistant", "tools", "vision", "reasoning"],
    "use_system_prompt": true,
    "is_deprecated": false,
    "is_enabled": true,
    "is_beta": false,
    "price_tier": 3,
    "price_tier_max": 3,
    "auto_tiers": [],
    "is_new": false
  },
  {
    "id": "9a1b2c3d-4e5f-4061-8a7b-6c5d4e3f2a10",
    "model_id": "example-auto",
    "model_type": "llm",
    "provider": "openai_responses",
    "display_name": "Auto",
    "description": "Picks a suitable model for every message.",
    "multilang_description": {},
    "max_tokens": 16000,
    "max_reasoning_tokens": 0,
    "capabilities": ["chat", "stream", "assistant", "tools"],
    "use_system_prompt": true,
    "is_deprecated": false,
    "is_enabled": true,
    "is_beta": true,
    "price_tier": 1,
    "price_tier_max": 3,
    "auto_tiers": ["example-chat-mini", "example-chat-large"],
    "is_new": true
  }
]

Model #

Typy modelů #

Přímo přes toto API (v chatu a u asistentů) lze používat jen modely llm. Ostatní typy jsou uvedeny, abyste viděli, co používají nástroje serveru.

Schopnosti #

Cenové úrovně #

price_tier umisťuje model na stupnici od 1 (nejlevnější) do 4 (nejdražší) podle jeho ceny za výstup ve srovnání s pevnými hranicemi pro každý typ modelu:

Skutečné náklady na použití modelu se účtují v kreditech; viz účet.

Automatické modely #

Automatický model je model llm, jehož seznam auto_tiers není prázdný. Sám neodpovídá: pro každou zprávu vybere jeden z modelů v auto_tiers, levnější pro jednoduché zprávy a silnější pro náročné. Jeho model_id používejte jako u kteréhokoli jiného modelu. Jeho price_tier a price_tier_max pokrývají rozpětí od nejlevnějšího po nejdražší z těchto modelů. Jeho schopnosti jsou ty, které sdílejí všechny jeho modely úrovní, a jeho max_tokens je nejmenší limit mezi nimi.

Výpis nástrojů #

Vrací AI nástroje, které může asistent používat. Asistent uvádí nástroje, které smí používat, v ai_tools, podle name nástroje.

Seznam vynechává nástroje, které nejsou určeny k ručnímu výběru (skryté pomocné nástroje, které server přidává automaticky tam, kde jsou potřeba), a vyřazené nástroje, takže is_hidden a is_deprecated jsou v něm vždy false. Obsahuje nástroje, které fungují jen v organizaci (organization_only). Některé nástroje navíc potřebují k čemukoli připojený účet (například Google nebo Microsoft) nebo spárovaného desktopového klienta.

display_name, description a category jsou přeloženy do jazyka z hlavičky požadavku language (EN, CZ nebo FR; výchozí EN).

Požadavek #

Tělo není potřeba.

Odpověď #

200 OK s polem nástrojů.

Chyby #

Tento endpoint nemá žádné chyby specifické pro sebe. Chyby autentizace, limitů požadavků a serveru jsou popsány v konvencích.

Příklad #

curl -X POST "https://ayeto.ai/api/v3/ai_tool/get_all" \
  -H "uni-api-key: $AYETO_API_KEY" \
  -H "language: EN"

[
  {
    "name": "DownloadUrlFunctionTool",
    "display_name": "Download URL",
    "description": "Download content from a URL",
    "icon": "ayeto",
    "is_advanced": false,
    "is_hidden": false,
    "is_deprecated": false,
    "is_silent": false,
    "organization_only": false,
    "tags": ["download", "url", "web", "content", "internet"],
    "category": "Web service",
    "group": null,
    "in_default_assistant": true,
    "always": false,
    "companion_of_group": null,
    "order": 0
  },
  {
    "name": "AssistantMemoryFunctionTool",
    "display_name": "Assistant Memory",
    "description": "Manage the assistant's memory which persists across conversations. Use to store important information that the assistant should remember.",
    "icon": "ayeto",
    "is_advanced": false,
    "is_hidden": false,
    "is_deprecated": false,
    "is_silent": true,
    "organization_only": false,
    "tags": [],
    "category": "General",
    "group": null,
    "in_default_assistant": false,
    "always": false,
    "companion_of_group": null,
    "order": 0
  }
]

Nástroj #