Jurnal de modificări
Actualizări și îmbunătățiri recente ale Shannon API.
Această pagină listează modificările pe care le poți observa ca apelant al API-ului: endpoint-uri, câmpuri și modele noi, comportament schimbat și remedieri. Cele mai noi intrări sunt primele. Fiecare intrare poartă data la care a fost făcută modificarea.
O intrare marcată Modificare incompatibilă poate schimba rezultatul unei cereri care funcționa înainte. API-ul are o singură versiune, /v1, deci modificările sunt listate după dată, nu după număr de versiune.
- Nou
O cerere cu
web_search: trueîși numește sursele:sourcespe/v1/chat/completionsși/v1/messageslistează rezultatele date modelului, iar pe/v1/chat/completionsannotationsmarchează unde citează răspunsul fiecare rezultat. Căutare web integrată
- Nou
web_search: truepe/v1/chat/completionsși/v1/messagesrulează o căutare web înainte ca modelul să răspundă și îi dă rezultatele ca surse numerotate. O cerere care a găsit rezultate consumă o căutare din cota ta zilnică. Dacă nu a mai rămas niciuna, cererea primește răspuns fără căutare. Căutare web integrată
- Remediat
Un stream întrerupt pe partea de server este facturat pentru utilizarea raportată până în acel punct. Restul rezervării revine în soldul tău.
- Remediat
shannon-coder-1răspunde pe/v1/responsesla fel ca pe celelalte două endpoint-uri. Instrumente CLI pentru programare - Remediat
O cheie API rotită încetează să funcționeze imediat.
- Nou
POST /v1/tokenizeșiPOST /v1/messages/count_tokens: numărări gratuite de token-uri pentru modelele open-weight găzduite. Numărarea token-urilor - Nou
Caching de prompt pe modelele open-weight găzduite. Intrarea din cache este facturată la 25% din prețul de intrare și raportată în
usagepe toate cele trei endpoint-uri:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensșicache_read_input_tokens.GET /v1/modelsraporteazăpricing.cached_input_per_million_usdșicapabilities.prompt_cachingpentru aceste modele. Caching de prompt - Remediat
Modele open-weight găzduite: un
tool_choiceforțat (requiredsau o funcție numită) produce un apel de instrument. Apelare funcții - Remediat
Modelele open-weight găzduite acceptă un mesaj
systemcare nu este primul mesaj al conversației.
- Nou
API-ul este accesibil ca serviciu onion Tor și la o adresă I2P. Răspunsurile de la
api.shannon-ai.compoartă cele două adrese în header-eleOnion-LocationșiX-I2P-Location. Endpoint-uri criptate, Tor & I2P
- Nou
Modele noi
shannon-3.1șishannon-3.1-pro, listate deGET /v1/models. Modele și prețuri - Modificat
O cerere cu streaming al cărei client se deconectează rulează până la capăt și este numărată. Înainte, răspunsul se oprea la deconectare.
- Remediat
Cererile către
/v1/responsesapar în jurnalul de utilizare.
- Nou
Modelele open-weight găzduite aplică câmpurile de eșantionare:
temperature,top_p,seed,stopșimax_tokenspe/v1/chat/completions;temperature,top_pșistop_sequencespe/v1/messages;temperature,top_pșimax_output_tokenspe/v1/responses. Chat Completions - Nou
Jurnalul de utilizare arată un cost în USD pentru fiecare apel și ca total.
- Modificare incompatibilă
O valoare
modelcare nu este un id publicat primește răspuns400, cu tipulinvalid_request_errorși mesajulunknown model: <id>, pe toate cele trei endpoint-uri. Înainte, o astfel de cerere primea răspuns de lashannon-1.6-lite. Modele și prețuri - Modificare incompatibilă
/v1acceptă doar o cheie API. Un cookie de autentificare al site-ului nu este citit acolo. Autentificare - Modificat
Protecție anti-flood: 120 de cereri pe minut pe cont, pe cele trei endpoint-uri de generare. Limite și sold
- Îmbunătățit
Când modelul nu poate răspunde, eroarea poartă mesajul fix
The model backend failed to answer. Please retry.O verificare a soldului care nu poate fi făcută primește răspuns503cu tipulapi_error. Gestionare erori - Remediat
O cerere fără streaming care eșuează înapoiază rezervarea în soldul tău.
- Nou
GET /v1/modelsraporteazăcapabilities.reasoning_effortpentru fiecare model. Efort de raționament - Îmbunătățit
Modele open-weight găzduite: o cerere fără streaming care nu primește răspuns se încheie cu
504și tipulapi_error. Un rezultat gol este502. Gestionare erori
- Modificare incompatibilă
Modelele open-weight găzduite acceptă intrarea pe care o acceptă modelul numit. O imagine trimisă unui id doar-text primește răspuns
400cu<id> does not accept image input.response_formatpe un id fără ieșire structurată primește răspuns400.GET /v1/modelsraporteazăcapabilities.vision,response_formatșijson_schemapentru fiecare id. Imagini și fișiere - Remediat
Răspunsurile fără streaming poartă textul de raționament:
reasoning_contentpe mesajul de la/v1/chat/completionsși un blocthinkingînaintea textului pe/v1/messages. Efort de raționament - Modificat
Modelele open-weight găzduite au prețuri noi, de la $0.50 per 1M token-uri de intrare și $2.00 per 1M token-uri de ieșire. Modele și prețuri
- Modificat
Modelele open-weight găzduite au un id pe model, douăsprezece id-uri în total. Modele și prețuri
- Nou
Ieșire structurată pe
shannon-3,shannon-3-pro,shannon-3.1șishannon-3.1-pro.GET /v1/modelsraporteazăcapabilities.json_schema: truepentru ele. Rezultate structurate - Nou
/v1/responsesciteștetext.format(json_objectsaujson_schema) pentru ieșirea structurată. Responses API - Remediat
/v1/responsesreturnează raționamentul modelelor Shannon: un element de ieșirereasoningînaintea elementuluimessageși evenimentele de streamresponse.reasoning_summary_text.deltașiresponse.reasoning_summary_text.done. Responses API - Remediat
Câmpul
modelal unui răspuns este id-ul publicat, pe fiecare endpoint. Un obiect Responses poartămodelșicreated_at. - Îmbunătățit
GET /v1/modelsraportează fereastra de context a fiecărui model. Modele și prețuri
- Nou
Modelele open-weight găzduite răspund pe
/v1/messagesși/v1/responses, nu doar pe/v1/chat/completions, cu system prompt-ul și apelurile tale de instrumente./v1/messagesacceptăthinking, iarreasoning_efforteste un câmp al cererii. Modele și prețuri - Îmbunătățit
Corpurile de eroare de pe
/v1urmează formele din SDK-uri: un obiecterrorcutypeșimessagepe endpoint-urile în format OpenAI și același obiect în interiorul{"type": "error"}pe/v1/messages. Gestionare erori - Nou
Keep-alive pe stream-urile deschise la fiecare 15 secunde: o linie de comentariu
: pingpe/v1/chat/completions, unevent: pingpe/v1/messages. Streaming - Modificat
Id-urile apelurilor de instrument încep cu
call_pe/v1/chat/completionsși/v1/responses, iar pe/v1/messagescutoolu_. Apelare funcții - Modificare incompatibilă
/v1/responses:streamare implicit valoareafalse. Responses API - Nou
max_completion_tokenseste acceptat ca alt nume pentrumax_tokenspe/v1/chat/completions. Chat Completions - Remediat
Evenimentul
response.completedal unui stream Responses poartă matriceaoutput. Responses API - Nou
Intrările
GET /v1/modelspoartădisplay_name,context_window,max_output_tokens,pricing,capabilitiesșiendpoints. Modele și prețuri - Nou
Fiecare răspuns poartă
x-request-id, iar o valoare trimisă de tine este returnată. Corpurile cererilor pot avea până la 32 MiB. - Nou
O cheie poate fi revocată fără să se emită una nouă. Jurnalul de utilizare este paginat.
- Nou
Imagini și documente în cereri: părți
image_urlpe/v1/chat/completions, blocuriimage,documentșifilepe/v1/messages, părțiinput_imagepe/v1/responses. Imagini și fișiere - Nou
Model nou
shannon-3-pro. Modele și prețuri
- Nou
Model nou
shannon-3. Modele și prețuri - Nou
Stream-urile de pe
/v1/chat/completionspoartă raționamentul cadelta.reasoning_content. Efort de raționament
- Modificat
max_tokenseste păstrat între 1 și 65,536. O valoare în afara acestui interval este adusă la cel mai apropiat capăt, nu refuzată. Chat Completions
- Nou
shannon-coder-1este numărat în apeluri per plan pe/v1/chat/completionsși/v1/messages. Când apelurile unei ferestre sunt consumate, răspunsul este429cu mesajulShannon Coder call quota reached. Instrumente CLI pentru programare - Nou
O conversație mai mare decât fereastra de context primește răspuns
400, cu tipulinvalid_request_errorși codulcontext_length_exceeded. O eroare în interiorul unui stream sosește ca eveniment de eroare, nu ca text în răspuns. Instrumente CLI pentru programare
- Nou
Endpoint-urile
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesșiGET /v1/models. Sunt endpoint-urile pe care le apelează SDK-urile OpenAI și Anthropic, Claude Code și Codex CLI. Prezentare generală - Nou
Apeluri de instrumente cu
toolspe/v1/chat/completionsși/v1/messages, ieșire structurată curesponse_formatșisystemca șir de caractere sau ca blocuri de text pe/v1/messages. Apelare funcții
- Nou
Id-urile de model
shannon-1.6-pro,shannon-2-lite,shannon-2-proșishannon-coder-1, alături deshannon-1.6-lite. Modele și prețuri
- Nou
Prima versiune a API-ului: chat în formatul OpenAI și în formatul Anthropic, plus un endpoint Responses, fiecare apelat cu o cheie API care începe cu
sk-. Autentificare