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: truenomme ses sources :sourcessur/v1/chat/completionset/v1/messagesliste les résultats remis au modèle, et sur/v1/chat/completionsannotationsmarque où la réponse cite chacun d'eux. Recherche Web intégrée
- Nouveau
web_search: truesur/v1/chat/completionset/v1/messageslance 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-1répond sur/v1/responsescomme 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/tokenizeetPOST /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
usagesur les trois points de terminaison :prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensetcache_read_input_tokens.GET /v1/modelsindiquepricing.cached_input_per_million_usdetcapabilities.prompt_cachingpour ces modèles. Mise en cache du prompt - Corrigé
Modèles open-weight hébergés : un
tool_choiceforcé (requiredou une fonction nommée) produit un appel d'outil. Appel de fonction - Corrigé
Les modèles open-weight hébergés acceptent un message
systemqui 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.comportent les deux adresses dans les en-têtesOnion-LocationetX-I2P-Location. Points de terminaison chiffrés, Tor et I2P
- Nouveau
Nouveaux modèles
shannon-3.1etshannon-3.1-pro, listés parGET /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/responsesapparaissent dans le journal d'utilisation.
- Nouveau
Les modèles open-weight hébergés appliquent les champs d'échantillonnage :
temperature,top_p,seed,stopetmax_tokenssur/v1/chat/completions;temperature,top_petstop_sequencessur/v1/messages;temperature,top_petmax_output_tokenssur/v1/responses. Chat Completions - Nouveau
Le journal d'utilisation affiche un coût en USD pour chaque appel et en total.
- Rupture
Une valeur
modelqui n'est pas un id publié reçoit400, le typeinvalid_request_erroret le messageunknown model: <id>sur les trois points de terminaison. Auparavant, une telle requête recevait la réponse deshannon-1.6-lite. Modèles et tarifs - Rupture
/v1n'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çoit503et le typeapi_error. Gestion des erreurs - Corrigé
Une requête hors streaming qui échoue restitue sa réservation à votre solde.
- Nouveau
GET /v1/modelsindiquecapabilities.reasoning_effortpour 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
504et le typeapi_error. Un résultat vide donne502. 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
400et<id> does not accept image input.response_formatsur un id sans sortie structurée reçoit400.GET /v1/modelsindiquecapabilities.vision,response_formatetjson_schemapour chaque id. Images et fichiers - Corrigé
Les réponses hors streaming portent le texte de raisonnement :
reasoning_contentsur le message de/v1/chat/completions, et un blocthinkingavant 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.1etshannon-3.1-pro.GET /v1/modelsindiquecapabilities.json_schema: truepour eux. Résultats structurés - Nouveau
/v1/responseslittext.format(json_objectoujson_schema) pour la sortie structurée. API Responses - Corrigé
/v1/responsesrenvoie le raisonnement des modèles Shannon : un élément de sortiereasoningavant l'élémentmessage, et les événements de fluxresponse.reasoning_summary_text.deltaetresponse.reasoning_summary_text.done. API Responses - Corrigé
Le champ
modeld'une réponse est l'id publié sur chaque point de terminaison. Un objet Responses portemodeletcreated_at. - Amélioré
GET /v1/modelsindique 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/messageset/v1/responsescomme sur/v1/chat/completions, avec votre prompt système et vos appels d'outil./v1/messagesacceptethinking, etreasoning_effortest un champ de requête. Modèles et tarifs - Amélioré
Les corps d'erreur sur
/v1suivent les formes des SDK : un objeterroravectypeetmessagesur 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
: pingsur/v1/chat/completions, unevent: pingsur/v1/messages. Diffusion en continu - Modifié
Les ids d'appel d'outil commencent par
call_sur/v1/chat/completionset/v1/responses, et partoolu_sur/v1/messages. Appel de fonction - Rupture
/v1/responses:streamvautfalsepar défaut. API Responses - Nouveau
max_completion_tokensest accepté comme autre nom demax_tokenssur/v1/chat/completions. Chat Completions - Corrigé
L'événement
response.completedd'un flux Responses transporte le tableauoutput. API Responses - Nouveau
Les entrées de
GET /v1/modelsportentdisplay_name,context_window,max_output_tokens,pricing,capabilitiesetendpoints. 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_urlsur/v1/chat/completions, blocsimage,documentetfilesur/v1/messages, partiesinput_imagesur/v1/responses. Images et fichiers - Nouveau
Nouveau modèle
shannon-3-pro. Modèles et tarifs
- Nouveau
Nouveau modèle
shannon-3. Modèles et tarifs - Nouveau
Les flux sur
/v1/chat/completionstransportent le raisonnement dansdelta.reasoning_content. Effort de raisonnement
- Modifié
max_tokensest 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-1est compté en appels par forfait sur/v1/chat/completionset/v1/messages. Quand les appels d'une fenêtre sont épuisés, la réponse est429avec le messageShannon Coder call quota reached. Outils CLI de programmation - Nouveau
Une conversation plus grande que la fenêtre de contexte reçoit
400, le typeinvalid_request_erroret le codecontext_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/responsesetGET /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
toolssur/v1/chat/completionset/v1/messages, sortie structurée avecresponse_format, etsystemsous 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-proetshannon-coder-1, à côté deshannon-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