Sari la conținut
Jurnal de modificări

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: sources pe /v1/chat/completions și /v1/messages listează rezultatele date modelului, iar pe /v1/chat/completions annotations marchează unde citează răspunsul fiecare rezultat. Căutare web integrată

  • Nou

    web_search: true pe /v1/chat/completions și /v1/messages rulează 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-1 răspunde pe /v1/responses la 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 și POST /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 usage pe toate cele trei endpoint-uri: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens și cache_read_input_tokens. GET /v1/models raportează pricing.cached_input_per_million_usd și capabilities.prompt_caching pentru aceste modele. Caching de prompt

  • Remediat

    Modele open-weight găzduite: un tool_choice forțat (required sau o funcție numită) produce un apel de instrument. Apelare funcții

  • Remediat

    Modelele open-weight găzduite acceptă un mesaj system care 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.com poartă cele două adrese în header-ele Onion-Location și X-I2P-Location. Endpoint-uri criptate, Tor & I2P

  • Nou

    Modele noi shannon-3.1 și shannon-3.1-pro, listate de GET /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/responses apar în jurnalul de utilizare.

  • Nou

    Modelele open-weight găzduite aplică câmpurile de eșantionare: temperature, top_p, seed, stop și max_tokens pe /v1/chat/completions; temperature, top_p și stop_sequences pe /v1/messages; temperature, top_p și max_output_tokens pe /v1/responses. Chat Completions

  • Nou

    Jurnalul de utilizare arată un cost în USD pentru fiecare apel și ca total.

  • Modificare incompatibilă

    O valoare model care nu este un id publicat primește răspuns 400, cu tipul invalid_request_error și mesajul unknown model: <id>, pe toate cele trei endpoint-uri. Înainte, o astfel de cerere primea răspuns de la shannon-1.6-lite. Modele și prețuri

  • Modificare incompatibilă

    /v1 acceptă 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ăspuns 503 cu tipul api_error. Gestionare erori

  • Remediat

    O cerere fără streaming care eșuează înapoiază rezervarea în soldul tău.

  • Nou

    GET /v1/models raportează capabilities.reasoning_effort pentru 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 tipul api_error. Un rezultat gol este 502. 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 400 cu <id> does not accept image input. response_format pe un id fără ieșire structurată primește răspuns 400. GET /v1/models raportează capabilities.vision, response_format și json_schema pentru fiecare id. Imagini și fișiere

  • Remediat

    Răspunsurile fără streaming poartă textul de raționament: reasoning_content pe mesajul de la /v1/chat/completions și un bloc thinking î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 și shannon-3.1-pro. GET /v1/models raportează capabilities.json_schema: true pentru ele. Rezultate structurate

  • Nou

    /v1/responses citește text.format (json_object sau json_schema) pentru ieșirea structurată. Responses API

  • Remediat

    /v1/responses returnează raționamentul modelelor Shannon: un element de ieșire reasoning înaintea elementului message și evenimentele de stream response.reasoning_summary_text.delta și response.reasoning_summary_text.done. Responses API

  • Remediat

    Câmpul model al unui răspuns este id-ul publicat, pe fiecare endpoint. Un obiect Responses poartă model și created_at.

  • Îmbunătățit

    GET /v1/models raportează 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/messages acceptă thinking, iar reasoning_effort este un câmp al cererii. Modele și prețuri

  • Îmbunătățit

    Corpurile de eroare de pe /v1 urmează formele din SDK-uri: un obiect error cu type și message pe 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 : ping pe /v1/chat/completions, un event: ping pe /v1/messages. Streaming

  • Modificat

    Id-urile apelurilor de instrument încep cu call_ pe /v1/chat/completions și /v1/responses, iar pe /v1/messages cu toolu_. Apelare funcții

  • Modificare incompatibilă

    /v1/responses: stream are implicit valoarea false. Responses API

  • Nou

    max_completion_tokens este acceptat ca alt nume pentru max_tokens pe /v1/chat/completions. Chat Completions

  • Remediat

    Evenimentul response.completed al unui stream Responses poartă matricea output. Responses API

  • Nou

    Intrările GET /v1/models poartă display_name, context_window, max_output_tokens, pricing, capabilities și endpoints. 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_url pe /v1/chat/completions, blocuri image, document și file pe /v1/messages, părți input_image pe /v1/responses. Imagini și fișiere

  • Nou

    Model nou shannon-3-pro. Modele și prețuri

  • Modificat

    max_tokens este 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-1 este numărat în apeluri per plan pe /v1/chat/completions și /v1/messages. Când apelurile unei ferestre sunt consumate, răspunsul este 429 cu mesajul Shannon 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 tipul invalid_request_error și codul context_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 și GET /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 tools pe /v1/chat/completions și /v1/messages, ieșire structurată cu response_format și system ca ș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 și shannon-coder-1, alături de shannon-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