Ndryshime
Përditësime dhe përmirësime të fundit të Shannon API.
Kjo faqe liston ndryshimet që mund t'i vëzhgoni si thirrës i API-t: endpoint-e, fusha dhe modele të reja, sjellje të ndryshuar dhe rregullime. Shënimet më të reja vijnë të parat. Çdo shënim mban datën kur u bë ndryshimi.
Një shënim i shënuar si Ndryshim i madh mund ta ndryshojë rezultatin e një kërkese që punonte më parë. API-ja ka një version, /v1, prandaj ndryshimet listohen sipas datës dhe jo sipas numrit të versionit.
- E re
Një kërkesë me
web_search: trueemërton burimet e saj:sourceste/v1/chat/completionsdhe/v1/messagesrendit rezultatet që iu dhanë modelit, dhe te/v1/chat/completionsannotationsshënon ku përgjigjja citon secilin. Kërkim i integruar në ueb
- E re
web_search: truenë/v1/chat/completionsdhe/v1/messagesbën një kërkim në ueb para se modeli të përgjigjet dhe ia jep rezultatet si burime të numëruara. Një kërkesë që gjeti rezultate përdor një kërkim nga kuota juaj ditore. Kur nuk ka më, kërkesa merr përgjigje pa kërkim. Kërkim i integruar në ueb
- E rregulluar
Një stream që pritet nga ana e serverit faturohet për përdorimin e raportuar deri në atë pikë. Pjesa tjetër e rezervimit i kthehet bilancit tuaj.
- E rregulluar
shannon-coder-1përgjigjet në/v1/responsessi në dy endpoint-et e tjera. Mjete CLI për kodim - E rregulluar
Një çelës API i rrotulluar ndalon së punuari menjëherë.
- E re
POST /v1/tokenizedhePOST /v1/messages/count_tokens: numërime falas tokens-ash për modelet open-weight të hostuara. Numërimi i tokens-ave - E re
Caching i prompt-it te modelet open-weight të hostuara. Hyrja e ruajtur në cache faturohet me 25% të çmimit të hyrjes dhe raportohet te
usagenë të tri endpoint-et:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensdhecache_read_input_tokens.GET /v1/modelsraportonpricing.cached_input_per_million_usddhecapabilities.prompt_cachingpër këto modele. Caching i prompt-it - E rregulluar
Modelet open-weight të hostuara: një
tool_choicei detyruar (requiredose një funksion i emërtuar) jep një thirrje mjeti. Thirrje funksionesh - E rregulluar
Modelet open-weight të hostuara pranojnë një mesazh
systemqë nuk është mesazhi i parë i bisedës.
- E re
API-ja arrihet si shërbim Tor onion dhe në një adresë I2P. Përgjigjet e
api.shannon-ai.comi mbajnë dy adresat në header-atOnion-LocationdheX-I2P-Location. Endpoint-e të enkriptuara, Tor dhe I2P
- E re
Modele të reja
shannon-3.1dheshannon-3.1-pro, të listuara ngaGET /v1/models. Modelet dhe çmimet - E ndryshuar
Një kërkesë me stream, klienti i së cilës shkëputet, ekzekutohet deri në fund dhe numërohet. Më parë, përgjigjja ndalonte te shkëputja.
- E rregulluar
Kërkesat te
/v1/responsesshfaqen në regjistrin e përdorimit.
- E re
Modelet open-weight të hostuara zbatojnë fushat e kampionimit:
temperature,top_p,seed,stopdhemax_tokensnë/v1/chat/completions;temperature,top_pdhestop_sequencesnë/v1/messages;temperature,top_pdhemax_output_tokensnë/v1/responses. Chat Completions - E re
Regjistri i përdorimit tregon një kosto në USD për çdo thirrje dhe si total.
- Ndryshim i madh
Një vlerë
modelqë nuk është id e publikuar merr përgjigje400, llojininvalid_request_errordhe mesazhinunknown model: <id>në të tri endpoint-et. Më parë, një kërkesë e tillë merrte përgjigje ngashannon-1.6-lite. Modelet dhe çmimet - Ndryshim i madh
/v1pranon vetëm çelës API. Një cookie hyrjeje e faqes së uebit nuk lexohet aty. Autentikim - E ndryshuar
Mbrojtja nga vërshimi i kërkesave: 120 kërkesa në minutë për llogari në tri endpoint-et e gjenerimit. Kufijtë dhe bilanci
- E përmirësuar
Kur modeli nuk mund të përgjigjet, gabimi mban mesazhin e fiksuar
The model backend failed to answer. Please retry.Një kontroll bilanci që nuk mund të kryhet merr përgjigje503dhe llojinapi_error. Trajtimi i gabimeve - E rregulluar
Një kërkesë pa stream që dështon ia kthen rezervimin e saj bilancit tuaj.
- E re
GET /v1/modelsraportoncapabilities.reasoning_effortpër çdo model. Përpjekja e arsyetimit - E përmirësuar
Modelet open-weight të hostuara: një kërkesë pa stream që nuk merr përgjigje mbaron me
504dhe llojinapi_error. Një rezultat bosh është502. Trajtimi i gabimeve
- Ndryshim i madh
Modelet open-weight të hostuara pranojnë hyrjen që pranon modeli i emërtuar. Një imazh i dërguar te një id vetëm për tekst merr përgjigje
400dhe<id> does not accept image input.response_formatte një id pa dalje të strukturuar merr përgjigje400.GET /v1/modelsraportoncapabilities.vision,response_formatdhejson_schemapër çdo id. Imazhet dhe skedarët - E rregulluar
Përgjigjet pa stream mbajnë tekstin e arsyetimit:
reasoning_contentte mesazhi i/v1/chat/completions, dhe një bllokthinkingpara tekstit në/v1/messages. Përpjekja e arsyetimit - E ndryshuar
Modelet open-weight të hostuara kanë çmime të reja, nga $0.50 për 1M tokens hyrjeje dhe $2.00 për 1M tokens dalje. Modelet dhe çmimet
- E ndryshuar
Modelet open-weight të hostuara kanë një id për model, gjithsej dymbëdhjetë id. Modelet dhe çmimet
- E re
Dalje e strukturuar te
shannon-3,shannon-3-pro,shannon-3.1dheshannon-3.1-pro.GET /v1/modelsraportoncapabilities.json_schema: truepër to. Dalje të strukturuara - E re
/v1/responseslexontext.format(json_objectosejson_schema) për dalje të strukturuar. Responses API - E rregulluar
/v1/responseskthen arsyetimin e modeleve Shannon: një element daljereasoningpara elementitmessage, dhe ngjarjet e stream-itresponse.reasoning_summary_text.deltadheresponse.reasoning_summary_text.done. Responses API - E rregulluar
Fusha
modele një përgjigjeje është id-ja e publikuar në çdo endpoint. Një objekt Responses mbanmodeldhecreated_at. - E përmirësuar
GET /v1/modelsraporton dritaren e kontekstit të çdo modeli. Modelet dhe çmimet
- E re
Modelet open-weight të hostuara përgjigjen edhe në
/v1/messagesdhe/v1/responses, jo vetëm në/v1/chat/completions, me system prompt-in dhe thirrjet tuaja të mjeteve./v1/messagespranonthinking, dhereasoning_effortështë fushë kërkese. Modelet dhe çmimet - E përmirësuar
Trupat e gabimeve në
/v1ndjekin format e SDK-ve: një objekterrormetypedhemessagenë endpoint-et e formatit OpenAI, dhe i njëjti objekt brenda{"type": "error"}në/v1/messages. Trajtimi i gabimeve - E re
Keep-alive në stream-et e hapura çdo 15 sekonda: një rresht komenti
: pingnë/v1/chat/completions, njëevent: pingnë/v1/messages. Transmetim - E ndryshuar
Id-të e thirrjeve të mjeteve fillojnë me
call_në/v1/chat/completionsdhe/v1/responses, dhe metoolu_në/v1/messages. Thirrje funksionesh - Ndryshim i madh
/v1/responses:streamka parazgjedhjefalse. Responses API - E re
max_completion_tokenspranohet si emër tjetër përmax_tokensnë/v1/chat/completions. Chat Completions - E rregulluar
Ngjarja
response.completede një stream-i Responses mban vargunoutput. Responses API - E re
Hyrjet e
GET /v1/modelsmbajnëdisplay_name,context_window,max_output_tokens,pricing,capabilitiesdheendpoints. Modelet dhe çmimet - E re
Çdo përgjigje mban
x-request-id, dhe një vlerë që ju dërgoni kthehet. Trupat e kërkesave mund të jenë deri në 32 MiB. - E re
Një çelës mund të shfuqizohet pa u lëshuar një i ri. Regjistri i përdorimit është i faqosur.
- E re
Imazhe dhe dokumente në kërkesa: pjesë
image_urlnë/v1/chat/completions, blloqeimage,documentdhefilenë/v1/messages, pjesëinput_imagenë/v1/responses. Imazhet dhe skedarët - E re
Model i ri
shannon-3-pro. Modelet dhe çmimet
- E re
Model i ri
shannon-3. Modelet dhe çmimet - E re
Stream-et në
/v1/chat/completionse mbajnë arsyetimin sidelta.reasoning_content. Përpjekja e arsyetimit
- E ndryshuar
max_tokensmbahet brenda 1 deri 65,536. Një vlerë jashtë këtij intervali çohet te skaji më i afërt, nuk refuzohet. Chat Completions
- E re
shannon-coder-1numërohet në thirrje për plan në/v1/chat/completionsdhe/v1/messages. Kur thirrjet e një dritareje shterojnë, përgjigjja është429me mesazhinShannon Coder call quota reached. Mjete CLI për kodim - E re
Një bisedë më e madhe se dritarja e kontekstit merr përgjigje
400, llojininvalid_request_errordhe kodincontext_length_exceeded. Një gabim brenda një stream-i arrin si ngjarje gabimi, jo si tekst në përgjigje. Mjete CLI për kodim
- E re
Endpoint-et
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesdheGET /v1/models. Ato janë endpoint-et që thërrasin SDK-të OpenAI dhe Anthropic, Claude Code dhe Codex CLI. Përmbledhje - E re
Thirrje mjetesh me
toolsnë/v1/chat/completionsdhe/v1/messages, dalje e strukturuar meresponse_format, dhesystemsi string ose si blloqe teksti në/v1/messages. Thirrje funksionesh
- E re
Id-të e modeleve
shannon-1.6-pro,shannon-2-lite,shannon-2-prodheshannon-coder-1, pranëshannon-1.6-lite. Modelet dhe çmimet
- E re
Publikimi i parë i API-t: bisedë në formatin OpenAI dhe në formatin Anthropic, dhe një endpoint Responses, secili thirret me një çelës API që fillon me
sk-. Autentikim