Aller au contenu
Journal des modifications

Journal des modifications

Mises à jour et améliorations récentes de l'API Shannon.

Cette page liste les changements observables par un appelant de l'API : nouveaux points de terminaison, champs et modèles, comportement modifié et corrections. Les entrées les plus récentes viennent en premier. Chaque entrée porte la date du changement.

Une entrée marquée Rupture peut changer le résultat d'une requête qui fonctionnait auparavant. L'API n'a qu'une version, /v1, donc les changements sont listés par date et non par numéro de version.

  • Nouveau

    Une requête avec web_search: true nomme ses sources : sources sur /v1/chat/completions et /v1/messages liste les résultats remis au modèle, et sur /v1/chat/completions annotations marque où la réponse cite chacun d'eux. Recherche Web intégrée

  • Nouveau

    web_search: true sur /v1/chat/completions et /v1/messages lance une recherche web avant que le modèle réponde et lui donne les résultats sous forme de sources numérotées. Une requête qui a trouvé des résultats utilise une recherche de votre quota quotidien. S'il n'en reste aucune, la requête reçoit une réponse sans recherche. Recherche Web intégrée

  • Corrigé

    Un flux coupé côté serveur est facturé pour l'utilisation rapportée jusqu'à ce point. Le reste de la réservation revient à votre solde.

  • Corrigé

    shannon-coder-1 répond sur /v1/responses comme sur les deux autres points de terminaison. Outils CLI de programmation

  • Corrigé

    Une clé API renouvelée cesse de fonctionner immédiatement.

  • Nouveau

    POST /v1/tokenize et POST /v1/messages/count_tokens : comptages de tokens gratuits pour les modèles open-weight hébergés. Décompte de tokens

  • Nouveau

    Mise en cache du prompt sur les modèles open-weight hébergés. L'entrée en cache est facturée à 25% du prix d'entrée et indiquée dans usage sur les trois points de terminaison : prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens et cache_read_input_tokens. GET /v1/models indique pricing.cached_input_per_million_usd et capabilities.prompt_caching pour ces modèles. Mise en cache du prompt

  • Corrigé

    Modèles open-weight hébergés : un tool_choice forcé (required ou une fonction nommée) produit un appel d'outil. Appel de fonction

  • Corrigé

    Les modèles open-weight hébergés acceptent un message system qui n'est pas le premier message de la conversation.

  • Nouveau

    L'API est accessible comme service onion Tor et à une adresse I2P. Les réponses de api.shannon-ai.com portent les deux adresses dans les en-têtes Onion-Location et X-I2P-Location. Points de terminaison chiffrés, Tor et I2P

  • Nouveau

    Nouveaux modèles shannon-3.1 et shannon-3.1-pro, listés par GET /v1/models. Modèles et tarifs

  • Modifié

    Une requête en streaming dont le client se déconnecte va jusqu'au bout et est comptée. Auparavant, la réponse s'arrêtait à la déconnexion.

  • Corrigé

    Les requêtes vers /v1/responses apparaissent dans le journal d'utilisation.

  • Nouveau

    Les modèles open-weight hébergés appliquent les champs d'échantillonnage : temperature, top_p, seed, stop et max_tokens sur /v1/chat/completions ; temperature, top_p et stop_sequences sur /v1/messages ; temperature, top_p et max_output_tokens sur /v1/responses. Chat Completions

  • Nouveau

    Le journal d'utilisation affiche un coût en USD pour chaque appel et en total.

  • Rupture

    Une valeur model qui n'est pas un id publié reçoit 400, le type invalid_request_error et le message unknown model: <id> sur les trois points de terminaison. Auparavant, une telle requête recevait la réponse de shannon-1.6-lite. Modèles et tarifs

  • Rupture

    /v1 n'accepte qu'une clé API. Un cookie de connexion du site web n'y est pas lu. Authentification

  • Modifié

    Protection anti-flood : 120 requêtes par minute et par compte sur les trois points de terminaison de génération. Limites et solde

  • Amélioré

    Quand le modèle ne peut pas répondre, l'erreur porte le message fixe The model backend failed to answer. Please retry. Une vérification du solde impossible à effectuer reçoit 503 et le type api_error. Gestion des erreurs

  • Corrigé

    Une requête hors streaming qui échoue restitue sa réservation à votre solde.

  • Nouveau

    GET /v1/models indique capabilities.reasoning_effort pour chaque modèle. Effort de raisonnement

  • Amélioré

    Modèles open-weight hébergés : une requête hors streaming qui ne reçoit aucune réponse se termine par 504 et le type api_error. Un résultat vide donne 502. Gestion des erreurs

  • Rupture

    Les modèles open-weight hébergés acceptent l'entrée qu'accepte le modèle nommé. Une image envoyée à un id texte seul reçoit 400 et <id> does not accept image input. response_format sur un id sans sortie structurée reçoit 400. GET /v1/models indique capabilities.vision, response_format et json_schema pour chaque id. Images et fichiers

  • Corrigé

    Les réponses hors streaming portent le texte de raisonnement : reasoning_content sur le message de /v1/chat/completions, et un bloc thinking avant le texte sur /v1/messages. Effort de raisonnement

  • Modifié

    Les modèles open-weight hébergés ont de nouveaux prix, à partir de $0.50 par 1M de tokens d'entrée et $2.00 par 1M de tokens de sortie. Modèles et tarifs

  • Modifié

    Les modèles open-weight hébergés ont un id par modèle, douze ids au total. Modèles et tarifs

  • Nouveau

    Sortie structurée sur shannon-3, shannon-3-pro, shannon-3.1 et shannon-3.1-pro. GET /v1/models indique capabilities.json_schema: true pour eux. Résultats structurés

  • Nouveau

    /v1/responses lit text.format (json_object ou json_schema) pour la sortie structurée. API Responses

  • Corrigé

    /v1/responses renvoie le raisonnement des modèles Shannon : un élément de sortie reasoning avant l'élément message, et les événements de flux response.reasoning_summary_text.delta et response.reasoning_summary_text.done. API Responses

  • Corrigé

    Le champ model d'une réponse est l'id publié sur chaque point de terminaison. Un objet Responses porte model et created_at.

  • Amélioré

    GET /v1/models indique la fenêtre de contexte de chaque modèle. Modèles et tarifs

  • Nouveau

    Les modèles open-weight hébergés répondent sur /v1/messages et /v1/responses comme sur /v1/chat/completions, avec votre prompt système et vos appels d'outil. /v1/messages accepte thinking, et reasoning_effort est un champ de requête. Modèles et tarifs

  • Amélioré

    Les corps d'erreur sur /v1 suivent les formes des SDK : un objet error avec type et message sur les points de terminaison au format OpenAI, et le même objet dans {"type": "error"} sur /v1/messages. Gestion des erreurs

  • Nouveau

    Keep-alive sur les flux ouverts toutes les 15 secondes : une ligne de commentaire : ping sur /v1/chat/completions, un event: ping sur /v1/messages. Diffusion en continu

  • Modifié

    Les ids d'appel d'outil commencent par call_ sur /v1/chat/completions et /v1/responses, et par toolu_ sur /v1/messages. Appel de fonction

  • Rupture

    /v1/responses : stream vaut false par défaut. API Responses

  • Nouveau

    max_completion_tokens est accepté comme autre nom de max_tokens sur /v1/chat/completions. Chat Completions

  • Corrigé

    L'événement response.completed d'un flux Responses transporte le tableau output. API Responses

  • Nouveau

    Les entrées de GET /v1/models portent display_name, context_window, max_output_tokens, pricing, capabilities et endpoints. Modèles et tarifs

  • Nouveau

    Chaque réponse porte x-request-id, et une valeur que vous envoyez est renvoyée. Les corps de requête peuvent atteindre 32 MiB.

  • Nouveau

    Une clé peut être révoquée sans qu'une nouvelle soit émise. Le journal d'utilisation est paginé.

  • Nouveau

    Images et documents dans les requêtes : parties image_url sur /v1/chat/completions, blocs image, document et file sur /v1/messages, parties input_image sur /v1/responses. Images et fichiers

  • Nouveau

    Nouveau modèle shannon-3-pro. Modèles et tarifs

  • Modifié

    max_tokens est maintenu entre 1 et 65,536. Une valeur hors de cette plage est ramenée à la limite la plus proche, et non refusée. Chat Completions

  • Nouveau

    shannon-coder-1 est compté en appels par forfait sur /v1/chat/completions et /v1/messages. Quand les appels d'une fenêtre sont épuisés, la réponse est 429 avec le message Shannon Coder call quota reached. Outils CLI de programmation

  • Nouveau

    Une conversation plus grande que la fenêtre de contexte reçoit 400, le type invalid_request_error et le code context_length_exceeded. Une erreur dans un flux arrive comme un événement d'erreur, pas comme du texte dans la réponse. Outils CLI de programmation

  • Nouveau

    Les points de terminaison /v1 : POST /v1/chat/completions, POST /v1/messages, POST /v1/responses et GET /v1/models. Ce sont les points de terminaison qu'appellent les SDK OpenAI et Anthropic, Claude Code et Codex CLI. Aperçu

  • Nouveau

    Appels d'outil avec tools sur /v1/chat/completions et /v1/messages, sortie structurée avec response_format, et system sous forme de chaîne ou de blocs de texte sur /v1/messages. Appel de fonction

  • Nouveau

    Ids de modèle shannon-1.6-pro, shannon-2-lite, shannon-2-pro et shannon-coder-1, à côté de shannon-1.6-lite. Modèles et tarifs

  • Nouveau

    Première version de l'API : chat au format OpenAI et au format Anthropic, et un point de terminaison Responses, chacun appelé avec une clé API qui commence par sk-. Authentification