Modèles et outils

Le catalogue des modèles et le catalogue des outils sont les mêmes pour tous les utilisateurs du serveur. Utilisez-les pour trouver le model_id à envoyer au chat ou à définir sur un assistant, ainsi que les name des outils auxquels renvoie la liste d'outils d'un assistant.

Les deux endpoints renvoient le catalogue complet en une seule réponse ; il n'y a pas de pagination.

Lister les modèles #

Renvoie les modèles d'IA connus du serveur, éventuellement limités à un seul type. La liste n'est pas personnalisée : chaque utilisateur obtient le même catalogue, quelle que soit son organisation.

La liste contient aussi les modèles que les administrateurs ont désactivés (is_enabled false) ou retirés (is_deprecated true). Le chat refuse les deux (422 model is disabled / model is deprecated, voir Chat) ; choisissez des modèles avec is_enabled true et is_deprecated false. L'ordre de la liste n'est pas garanti.

Les prix concrets ne sont pas exposés. Utilisez price_tier pour une indication de prix relative, et le coût d'une conversation pour ce qu'une conversation a réellement coûté.

Requête #

Le corps est obligatoire ; envoyez {} pour obtenir les modèles de tous les types.

Réponse #

200 OK avec un tableau de modèles.

Erreurs #

Les erreurs d'authentification, de limite de débit et du serveur sont décrites dans les conventions.

Exemple #

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
  }
]

Modèle #

Types de modèles #

Seuls les modèles llm peuvent être utilisés directement via cette API (dans le chat et sur les assistants). Les autres types sont listés pour que vous puissiez voir ce qu'utilisent les outils du serveur.

Capacités #

Niveaux de prix #

price_tier situe le modèle sur une échelle allant de 1 (le moins cher) à 4 (le plus cher), en fonction de son prix de sortie comparé à des seuils fixes par type de modèle :

Le coût réel d'utilisation d'un modèle est facturé en crédits ; voir compte.

Modèles automatiques #

Un modèle automatique est un modèle llm dont la liste auto_tiers n'est pas vide. Il ne répond pas lui-même : pour chaque message, il choisit l'un des modèles de auto_tiers, un modèle moins cher pour les messages simples et un modèle plus puissant pour les messages exigeants. Utilisez son model_id comme celui de n'importe quel autre modèle. Ses price_tier et price_tier_max couvrent le moins cher et le plus cher de ces modèles. Ses capacités sont celles que partagent tous ses modèles de niveau, et son max_tokens est la plus petite limite parmi eux.

Lister les outils #

Renvoie les outils d'IA qu'un assistant peut utiliser. Un assistant liste les outils qu'il peut utiliser dans ai_tools, par name d'outil.

La liste omet les outils qui ne sont pas destinés à être choisis manuellement (des outils auxiliaires cachés que le serveur ajoute automatiquement là où ils sont nécessaires) ainsi que les outils retirés ; is_hidden et is_deprecated y valent donc toujours false. Elle inclut les outils qui ne fonctionnent qu'au sein d'une organisation (organization_only). Certains outils ont aussi besoin d'un compte connecté (par exemple Google ou Microsoft) ou d'un client de bureau appairé pour faire quoi que ce soit.

display_name, description et category sont traduits dans la langue indiquée dans l'en-tête de requête language (EN, CZ ou FR ; par défaut EN).

Requête #

Aucun corps n'est nécessaire.

Réponse #

200 OK avec un tableau d'outils.

Erreurs #

Cet endpoint n'a pas d'erreurs spécifiques. Les erreurs d'authentification, de limite de débit et du serveur sont décrites dans les conventions.

Exemple #

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
  }
]

Outil #