Tala ng pagbabago
Mga pinakabagong update at improvements sa Shannon API.
Inililista ng pahinang ito ang mga pagbabagong mapapansin mo bilang tumatawag sa API: mga bagong endpoint, field at model, nabagong gawi at mga ayos. Nauuna ang pinakabagong mga entry. Dala ng bawat entry ang petsa kung kailan ginawa ang pagbabago.
Ang entry na may markang Breaking ay maaaring magbago ng resulta ng request na gumagana noon. Iisa ang bersyon ng API, /v1, kaya inililista ang mga pagbabago ayon sa petsa at hindi ayon sa numero ng bersyon.
- Bago
Pinangangalanan ng request na may
web_search: trueang mga source nito: inililista ngsourcessa/v1/chat/completionsat/v1/messagesang mga resultang ibinigay sa model, at sa/v1/chat/completionsay minamarkahan ngannotationskung saan sinisipi ng sagot ang bawat isa. Web search
- Bago
Ang
web_search: truesa/v1/chat/completionsat/v1/messagesay nagsasagawa ng web search bago sumagot ang model at ibinibigay dito ang mga resulta bilang may bilang na mga source. Ang request na nakahanap ng mga resulta ay gumagamit ng isang search mula sa iyong daily allowance. Kapag wala nang natitira, sinasagot ang request nang walang search. Web search
- Naayos
Ang stream na pinutol sa panig ng server ay sinisingil para sa usage na naiulat hanggang sa puntong iyon. Bumabalik sa iyong balance ang natitirang reservation.
- Naayos
Sumasagot ang
shannon-coder-1sa/v1/responsestulad ng ginagawa nito sa dalawa pang endpoint. Mga CLI coding tool - Naayos
Agad na titigil gumana ang API key na na-rotate.
- Bago
POST /v1/tokenizeatPOST /v1/messages/count_tokens: libreng pagbibilang ng token para sa mga hosted open-weight model. Pagbibilang ng token - Bago
Prompt caching sa mga hosted open-weight model. Sinisingil ang cached input sa 25% ng input price at iniuulat sa
usagesa lahat ng tatlong endpoint:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensatcache_read_input_tokens. Iniuulat ngGET /v1/modelsangpricing.cached_input_per_million_usdatcapabilities.prompt_cachingpara sa mga model na ito. Prompt caching - Naayos
Mga hosted open-weight model: ang sapilitang
tool_choice(requiredo isang pinangalanang function) ay nagbibigay ng tool call. Function calling - Naayos
Tinatanggap ng mga hosted open-weight model ang
systemmessage na hindi ang unang message ng conversation.
- Bago
Maaabot ang API bilang Tor onion service at sa isang I2P address. Dala ng mga reply ng
api.shannon-ai.comang dalawang address sa mga header naOnion-LocationatX-I2P-Location. Mga encrypted, Tor at I2P endpoint
- Bago
Mga bagong model na
shannon-3.1atshannon-3.1-pro, na inililista ngGET /v1/models. Mga model at presyo - Binago
Ang naka-stream na request na nadiskonekta ang client ay tumatakbo hanggang dulo at binibilang. Dati, huminto ang sagot sa pagdiskonekta.
- Naayos
Lumalabas sa usage log ang mga request sa
/v1/responses.
- Bago
Ina-apply ng mga hosted open-weight model ang mga sampling field:
temperature,top_p,seed,stopatmax_tokenssa/v1/chat/completions;temperature,top_patstop_sequencessa/v1/messages;temperature,top_patmax_output_tokenssa/v1/responses. Chat Completions - Bago
Ipinapakita ng usage log ang gastos sa USD para sa bawat call at bilang kabuuan.
- Breaking
Ang value ng
modelna hindi inilathalang id ay sinasagot ng400, ang type nainvalid_request_errorat ang mensahengunknown model: <id>sa lahat ng tatlong endpoint. Dati, ang ganoong request ay sinasagot ngshannon-1.6-lite. Mga model at presyo - Breaking
API key lang ang tinatanggap ng
/v1. Hindi binabasa roon ang sign-in cookie ng website. Pagpapatunay - Binago
Flood protection: 120 request kada minuto kada account sa tatlong generation endpoint. Mga limitasyon at balance
- Pinahusay
Kapag hindi makasagot ang model, dala ng error ang nakapirming mensaheng
The model backend failed to answer. Please retry.Ang balance check na hindi magawa ay sinasagot ng503at ng type naapi_error. Paghawak ng Error - Naayos
Ang request na hindi naka-stream at nabigo ay ibinabalik ang reservation nito sa iyong balance.
- Bago
Iniuulat ng
GET /v1/modelsangcapabilities.reasoning_effortpara sa bawat model. Reasoning effort - Pinahusay
Mga hosted open-weight model: ang request na hindi naka-stream at walang nakuhang sagot ay nagtatapos sa
504at sa type naapi_error. Ang walang lamang resulta ay502. Paghawak ng Error
- Breaking
Tinatanggap ng mga hosted open-weight model ang input na tinatanggap ng pinangalanang model. Ang image na ipinadala sa text-only na id ay sinasagot ng
400at<id> does not accept image input. Angresponse_formatsa id na walang structured output ay sinasagot ng400. Iniuulat ngGET /v1/modelsangcapabilities.vision,response_formatatjson_schemapara sa bawat id. Mga image at file - Naayos
Dala ng mga reply na hindi naka-stream ang reasoning text:
reasoning_contentsa message ng/v1/chat/completions, at isangthinkingblock bago ang text sa/v1/messages. Reasoning effort - Binago
May mga bagong presyo ang mga hosted open-weight model, mula $0.50 kada 1M input tokens at $2.00 kada 1M output tokens. Mga model at presyo
- Binago
Isang id kada model ang mga hosted open-weight model, labindalawang id sa kabuuan. Mga model at presyo
- Bago
Structured output sa
shannon-3,shannon-3-pro,shannon-3.1atshannon-3.1-pro. Iniuulat ngGET /v1/modelsangcapabilities.json_schema: truepara sa mga ito. Structured outputs - Bago
Binabasa ng
/v1/responsesangtext.format(json_objectojson_schema) para sa structured output. Responses API - Naayos
Ibinabalik ng
/v1/responsesang reasoning ng mga Shannon model: isangreasoningoutput item bago angmessageitem, at ang mga stream event naresponse.reasoning_summary_text.deltaatresponse.reasoning_summary_text.done. Responses API - Naayos
Ang field na
modelng isang reply ay ang inilathalang id sa bawat endpoint. Dala ng isang Responses object angmodelatcreated_at. - Pinahusay
Iniuulat ng
GET /v1/modelsang context window ng bawat model. Mga model at presyo
- Bago
Sumasagot ang mga hosted open-weight model sa
/v1/messagesat/v1/responsespati sa/v1/chat/completions, kasama ang iyong system prompt at mga tool call. Tumatanggap ang/v1/messagesngthinking, at angreasoning_effortay isang request field. Mga model at presyo - Pinahusay
Sumusunod ang mga error body sa
/v1sa mga hugis ng SDK: isangerrorobject na maytypeatmessagesa mga endpoint na OpenAI-format, at ang parehong object sa loob ng{"type": "error"}sa/v1/messages. Paghawak ng Error - Bago
Keep-alive sa mga bukas na stream tuwing 15 segundo: isang
: pingcomment line sa/v1/chat/completions, isangevent: pingsa/v1/messages. Pag‑stream - Binago
Nagsisimula sa
call_ang mga tool call id sa/v1/chat/completionsat/v1/responses, at satoolu_sa/v1/messages. Function calling - Breaking
/v1/responses: ang default ngstreamayfalse. Responses API - Bago
Tinatanggap ang
max_completion_tokensbilang ibang pangalan ngmax_tokenssa/v1/chat/completions. Chat Completions - Naayos
Dala ng
response.completedevent ng isang Responses stream angoutputarray. Responses API - Bago
Dala ng mga entry ng
GET /v1/modelsangdisplay_name,context_window,max_output_tokens,pricing,capabilitiesatendpoints. Mga model at presyo - Bago
Dala ng bawat reply ang
x-request-id, at ibinabalik ang value na ipinadala mo. Maaaring umabot sa 32 MiB ang mga request body. - Bago
Maaaring i-revoke ang isang key nang hindi naglalabas ng bago. May paging ang usage log.
- Bago
Mga image at dokumento sa mga request: mga
image_urlpart sa/v1/chat/completions, mgaimage,documentatfileblock sa/v1/messages, mgainput_imagepart sa/v1/responses. Mga image at file - Bago
Bagong model na
shannon-3-pro. Mga model at presyo
- Bago
Bagong model na
shannon-3. Mga model at presyo - Bago
Dala ng mga stream sa
/v1/chat/completionsang reasoning bilangdelta.reasoning_content. Reasoning effort
- Binago
Pinananatili ang
max_tokenssa pagitan ng 1 hanggang 65,536. Ang value na wala sa saklaw na iyon ay dinadala sa pinakamalapit na dulo, hindi tinatanggihan. Chat Completions
- Bago
Binibilang ang
shannon-coder-1sa call kada plan sa/v1/chat/completionsat/v1/messages. Kapag naubos na ang mga call ng isang window,429ang reply na may mensahengShannon Coder call quota reached. Mga CLI coding tool - Bago
Ang conversation na mas malaki kaysa sa context window ay sinasagot ng
400, ang type nainvalid_request_errorat ang code nacontext_length_exceeded. Ang error sa loob ng stream ay dumarating bilang error event, hindi bilang text sa sagot. Mga CLI coding tool
- Bago
Ang mga
/v1endpoint:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesatGET /v1/models. Ito ang mga endpoint na tinatawag ng mga OpenAI at Anthropic SDK, Claude Code at Codex CLI. Pangkalahatang-ideya - Bago
Mga tool call gamit ang
toolssa/v1/chat/completionsat/v1/messages, structured output gamit angresponse_format, atsystembilang string o bilang mga text block sa/v1/messages. Function calling
- Bago
Mga model id na
shannon-1.6-pro,shannon-2-lite,shannon-2-proatshannon-coder-1, bukod sashannon-1.6-lite. Mga model at presyo
- Bago
Unang release ng API: chat sa OpenAI format at sa Anthropic format, at isang Responses endpoint, na bawat isa ay tinatawag gamit ang API key na nagsisimula sa
sk-. Pagpapatunay