Capacités

Chaque modèle est accessible via les mêmes trois points de terminaison avec la même clé. Les deux tableaux montrent où les modèles diffèrent. Un tiret signifie que le modèle répond sans cette capacité.

Modèles Shannon

Modèles open-weight hébergés

L'id d'un modèle hébergé est son nom et sa variante joints par un trait d'union, par exemple DeepSeek-V4-Pro-0813-3BIT-REAP.

Ce que signifie chaque colonne

• Outils. Vous décrivez des fonctions dans tools, le modèle répond avec les appels qu'il veut faire, et votre code les exécute. Chaque modèle accepte les outils. Un tool_choice forcé est appliqué par les modèles open-weight hébergés. Appel de fonction
• Entrée image. Le modèle lit les images envoyées dans un message utilisateur, sous forme d'URL de données ou d'adresse. shannon-2-lite et shannon-2-pro lisent les images dans les requêtes qui envoient aussi tools ou response_format. La famille Shannon 3 lit aussi les documents. Images et fichiers
• Raisonnement. La réponse peut porter le texte de raisonnement du modèle à côté de la réponse, dans un champ distinct. Effort de raisonnement
• Effort de raisonnement. Un champ de requête règle la profondeur du raisonnement du modèle : off, low, medium ou high. Les modèles Shannon règlent eux-mêmes leur profondeur. Effort de raisonnement
• Objet JSON. Avec response_format: {"type": "json_object"}, la réponse est du JSON sans forme prescrite. Sur /v1/chat/completions et /v1/responses. Résultats structurés
• Schéma JSON. Avec un response_format de type json_schema, la réponse suit un schéma que vous envoyez. Sur /v1/chat/completions et /v1/responses. Résultats structurés
• Mise en cache du prompt. Un prompt qui commence comme un prompt récent sur le même modèle est lu dans le cache, et la partie en cache est facturée à 25% du prix d'entrée. Aucun champ de requête n'est nécessaire. Mise en cache du prompt
• Recherche web. Avec web_search: true, l'API cherche sur le web et donne les résultats au modèle avant qu'il réponde. Sur /v1/chat/completions et /v1/messages. C'est un champ de la requête et il n'a pas d'indicateur dans GET /v1/models. Recherche Web intégrée
• Streaming. Avec stream: true, la réponse arrive sous forme de server-sent events pendant que le modèle écrit. Chaque modèle diffuse en streaming sur les trois points de terminaison. Diffusion en continu

Les mêmes faits via GET /v1/models

GET https://api.shannon-ai.com/v1/models

GET /v1/models liste chaque modèle avec un objet capabilities, de sorte qu'un programme peut lire ces faits au lieu de cette page. Le point de terminaison n'exige aucune clé.

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });

for await (const model of client.models.list()) {
  console.log(model.id, model.capabilities);
}

curl https://api.shannon-ai.com/v1/models

L'id et les capabilities de deux entrées de data :

[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]

• response_format et prompt_caching sont des indicateurs des entrées open-weight hébergées. Une entrée Shannon indique la sortie JSON avec json_schema seul, qui représente les deux modes JSON.
• vision vaut true pour shannon-2-lite et shannon-2-pro : ils lisent les images dans les requêtes qui envoient aussi tools ou response_format.

Hors de la ligne d'un modèle

Un modèle open-weight hébergé refuse une image ou un mode JSON qui n'est pas dans sa ligne. Le refus intervient avant que quoi que ce soit soit prélevé sur votre solde :

Un modèle Shannon répond à une telle requête avec le statut 200 : la capacité absente de sa ligne ne participe pas à la réponse. Gestion des erreurs