Log tal-bidliet
Aġġornamenti u titjib reċenti għall-API Shannon.
Din il-paġna telenka l-bidliet li tista' tosserva bħala min isejjaħ l-API: endpoints, kampi u mudelli ġodda, imġiba mibdula u tiswijiet. L-aktar daħliet ġodda jiġu l-ewwel. Kull daħla ġġorr id-data li fiha saret il-bidla.
Daħla mmarkata Tkissir tista' tbiddel ir-riżultat ta' talba li qabel kienet taħdem. L-API għandu verżjoni waħda, /v1, għalhekk il-bidliet huma mniżżla skont id-data u mhux skont in-numru tal-verżjoni.
- Ġdid
Talba b'
web_search: trueisemmi s-sorsi tagħha:sourcesfuq/v1/chat/completionsu/v1/messagestelenka r-riżultati mogħtija lill-mudell, u fuq/v1/chat/completionsannotationstimmarka fejn it-tweġiba ssemmi kull wieħed. Tfittxija Web inkorporata
- Ġdid
web_search: truefuq/v1/chat/completionsu/v1/messagesiħaddem fittxija fuq il-web qabel ma l-mudell iwieġeb u jagħtih ir-riżultati bħala sorsi mnumerati. Talba li sabet riżultati tuża fittxija waħda mill-kwota ta' kuljum tiegħek. Meta ma tibqa' ebda waħda, it-talba tiġi mwieġba mingħajr fittxija. Tfittxija Web inkorporata
- Fissat
Stream li jinqata' fuq in-naħa tas-server jitħallas għall-użu rrapportat sa dak il-punt. Il-bqija tar-riżerva terġa' lura għall-bilanċ tiegħek.
- Fissat
shannon-coder-1iwieġeb fuq/v1/responsesbħalma jagħmel fuq iż-żewġ endpoints l-oħra. Għodod CLI għall-kodiċi - Fissat
Ċavetta tal-API iddawwra tieqaf taħdem minnufih.
- Ġdid
POST /v1/tokenizeuPOST /v1/messages/count_tokens: għadd ta' tokens b'xejn għall-mudelli open-weight ospitati. Għadd ta' tokens - Ġdid
Prompt caching fuq il-mudelli open-weight ospitati. L-input cached jitħallas bi 25% tal-prezz tal-input u jiġi rrapportat f'
usagefuq it-tliet endpoints kollha:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensucache_read_input_tokens.GET /v1/modelsjirrapportapricing.cached_input_per_million_usducapabilities.prompt_cachinggħal dawn il-mudelli. Prompt caching - Fissat
Mudelli open-weight ospitati:
tool_choicefurzat (requiredjew funzjoni msemmija) jagħti sejħa ta' tool. Sejħiet ta' Funzjonijiet - Fissat
Il-mudelli open-weight ospitati jaċċettaw messaġġ
systemli mhuwiex l-ewwel messaġġ tal-konversazzjoni.
- Ġdid
L-API jintlaħaq bħala servizz onion ta' Tor u f'indirizz I2P. It-tweġibiet ta'
api.shannon-ai.comiġorru ż-żewġ indirizzi fl-headersOnion-LocationuX-I2P-Location. Endpoints ikkriptati, Tor & I2P
- Ġdid
Mudelli ġodda
shannon-3.1ushannon-3.1-pro, imniżżla minnGET /v1/models. Mudelli u prezzijiet - Mibdul
Talba bi streaming li l-klijent tagħha jiskonnettja titmexxa sat-tmiem u tingħadd. Qabel, it-tweġiba kienet tieqaf mal-iskonnessjoni.
- Fissat
It-talbiet lil
/v1/responsesjidhru fil-log tal-użu.
- Ġdid
Il-mudelli open-weight ospitati japplikaw il-kampi tas-sampling:
temperature,top_p,seed,stopumax_tokensfuq/v1/chat/completions;temperature,top_pustop_sequencesfuq/v1/messages;temperature,top_pumax_output_tokensfuq/v1/responses. Chat Completions - Ġdid
Il-log tal-użu juri spiża f'USD għal kull sejħa u bħala total.
- Tkissir
Valur
modelli mhuwiex id ippubblikat jiġi mwieġeb b'400, it-tipinvalid_request_erroru l-messaġġunknown model: <id>fuq it-tliet endpoints kollha. Qabel, talba bħal din kienet tiġi mwieġba minnshannon-1.6-lite. Mudelli u prezzijiet - Tkissir
/v1jieħu biss ċavetta tal-API. Cookie ta' dħul tal-websajt ma jinqarax hemm. Awtentikazzjoni - Mibdul
Protezzjoni mill-flood: 120 talba kull minuta għal kull kont fuq it-tliet endpoints tal-ġenerazzjoni. Limiti u bilanċ
- Mtejjeb
Meta l-mudell ma jistax iwieġeb, l-iżball iġorr il-messaġġ fiss
The model backend failed to answer. Please retry.Verifika tal-bilanċ li ma tistax issir tiġi mwieġba b'503u t-tipapi_error. Ġestjoni tal-iżbalji - Fissat
Talba mingħajr streaming li tfalli tagħti lura r-riżerva tagħha lill-bilanċ tiegħek.
- Ġdid
GET /v1/modelsjirrapportacapabilities.reasoning_effortgħal kull mudell. Sforz ta' raġunament - Mtejjeb
Mudelli open-weight ospitati: talba mingħajr streaming li ma tikseb ebda tweġiba tintemm b'
504u t-tipapi_error. Riżultat vojt huwa502. Ġestjoni tal-iżbalji
- Tkissir
Il-mudelli open-weight ospitati jieħdu l-input li jieħu l-mudell imsemmi. Immaġni mibgħuta lil id tat-test biss tiġi mwieġba b'
400u<id> does not accept image input.response_formatfuq id mingħajr output strutturat jiġi mwieġeb b'400.GET /v1/modelsjirrapportacapabilities.vision,response_formatujson_schemagħal kull id. Immaġini u fajls - Fissat
Tweġibiet mingħajr streaming iġorru t-test tar-raġunament:
reasoning_contentfuq il-messaġġ ta'/v1/chat/completions, u blokkthinkingqabel it-test fuq/v1/messages. Sforz ta' raġunament - Mibdul
Il-mudelli open-weight ospitati għandhom prezzijiet ġodda, minn $0.50 għal kull 1M input tokens u $2.00 għal kull 1M output tokens. Mudelli u prezzijiet
- Mibdul
Il-mudelli open-weight ospitati għandhom id wieħed għal kull mudell, tnax-il id b'kollox. Mudelli u prezzijiet
- Ġdid
Output strutturat fuq
shannon-3,shannon-3-pro,shannon-3.1ushannon-3.1-pro.GET /v1/modelsjirrapportacapabilities.json_schema: truegħalihom. Outputs Strutturati - Ġdid
/v1/responsesjaqratext.format(json_objectjewjson_schema) għall-output strutturat. Responses API - Fissat
/v1/responsesjagħti lura r-raġunament tal-mudelli Shannon: element tal-outputreasoningqabel l-elementmessage, u l-avvenimenti tal-istreamresponse.reasoning_summary_text.deltauresponse.reasoning_summary_text.done. Responses API - Fissat
Il-qasam
modelta' tweġiba huwa l-id ippubblikat fuq kull endpoint. Oġġett Responses iġorrmodelucreated_at. - Mtejjeb
GET /v1/modelsjirrapporta t-tieqa tal-kuntest ta' kull mudell. Mudelli u prezzijiet
- Ġdid
Il-mudelli open-weight ospitati jwieġbu fuq
/v1/messagesu/v1/responseskif ukoll fuq/v1/chat/completions, bis-system prompt u s-sejħiet ta' tools tiegħek./v1/messagesjieħuthinking, ureasoning_efforthuwa qasam tat-talba. Mudelli u prezzijiet - Mtejjeb
Il-bodies tal-iżbalji fuq
/v1isegwu l-forom tal-SDKs: oġġetterrorb'typeumessagefuq l-endpoints tal-format OpenAI, u l-istess oġġett ġewwa{"type": "error"}fuq/v1/messages. Ġestjoni tal-iżbalji - Ġdid
Keep-alive fuq l-istreams miftuħa kull 15-il sekonda: linja ta' kumment
: pingfuq/v1/chat/completions,event: pingfuq/v1/messages. Streaming - Mibdul
L-ids tas-sejħiet ta' tools jibdew b'
call_fuq/v1/chat/completionsu/v1/responses, u b'toolu_fuq/v1/messages. Sejħiet ta' Funzjonijiet - Tkissir
/v1/responses:streamhuwafalseb'default. Responses API - Ġdid
max_completion_tokensjiġi aċċettat bħala isem ieħor għalmax_tokensfuq/v1/chat/completions. Chat Completions - Fissat
L-avveniment
response.completedta' stream Responses iġorr l-arrayoutput. Responses API - Ġdid
L-entrati ta'
GET /v1/modelsiġorrudisplay_name,context_window,max_output_tokens,pricing,capabilitiesuendpoints. Mudelli u prezzijiet - Ġdid
Kull tweġiba ġġorr
x-request-id, u valur li tibgħat jiġi rritornat. Il-bodies tat-talbiet jistgħu jkunu sa 32 MiB. - Ġdid
Ċavetta tista' tiġi rrevokata mingħajr ma tinħareġ waħda ġdida. Il-log tal-użu huwa maqsum f'paġni.
- Ġdid
Immaġini u dokumenti fit-talbiet: partijiet
image_urlfuq/v1/chat/completions, blokokimage,documentufilefuq/v1/messages, partijietinput_imagefuq/v1/responses. Immaġini u fajls - Ġdid
Mudell ġdid
shannon-3-pro. Mudelli u prezzijiet
- Ġdid
Mudell ġdid
shannon-3. Mudelli u prezzijiet - Ġdid
L-istreams fuq
/v1/chat/completionsjġorru r-raġunament bħaladelta.reasoning_content. Sforz ta' raġunament
- Mibdul
max_tokensjinżamm bejn 1 u 65,536. Valur barra minn din il-medda jitressaq lejn l-eqreb tarf, mhux miċħud. Chat Completions
- Ġdid
shannon-coder-1jingħadd f'sejħiet għal kull pjan fuq/v1/chat/completionsu/v1/messages. Meta s-sejħiet ta' tieqa jintefqu, it-tweġiba hija429bil-messaġġShannon Coder call quota reached. Għodod CLI għall-kodiċi - Ġdid
Konversazzjoni akbar mit-tieqa tal-kuntest tiġi mwieġba b'
400, it-tipinvalid_request_erroru l-kodiċicontext_length_exceeded. Żball ġo stream jasal bħala avveniment ta' żball, mhux bħala test fit-tweġiba. Għodod CLI għall-kodiċi
- Ġdid
L-endpoints
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesuGET /v1/models. Huma l-endpoints li jsejħu l-SDKs ta' OpenAI u Anthropic, Claude Code u Codex CLI. Ħarsa ġenerali - Ġdid
Sejħiet ta' tools b'
toolsfuq/v1/chat/completionsu/v1/messages, output strutturat b'response_format, usystembħala string jew bħala blokok tat-test fuq/v1/messages. Sejħiet ta' Funzjonijiet
- Ġdid
L-ids tal-mudelli
shannon-1.6-pro,shannon-2-lite,shannon-2-proushannon-coder-1, maġenbshannon-1.6-lite. Mudelli u prezzijiet
- Ġdid
L-ewwel rilaxx tal-API: chat fil-format OpenAI u fil-format Anthropic, u endpoint Responses, kull wieħed jissejjaħ b'ċavetta tal-API li tibda b'
sk-. Awtentikazzjoni