Loga athrú
Nuashonruithe agus feabhsuithe le déanaí ar API na Sionainne.
Liostaíonn an leathanach seo na hathruithe is féidir leat a thabhairt faoi deara mar ghlaoiteoir an API: críochphointí, réimsí agus múnlaí nua, iompar athraithe agus socruithe. Tagann na hiontrálacha is nuaí ar dtús. Tá dáta an athraithe i ngach iontráil.
Féadfaidh iontráil atá marcáilte Briseadh toradh iarratais a d'oibrigh roimhe seo a athrú. Tá leagan amháin ag an API, /v1, mar sin liostaítear athruithe de réir dáta agus ní de réir uimhir leagain.
- Nua
Ainmníonn iarratas a bhfuil
web_search: trueair a fhoinsí: liostaíonnsourcesar/v1/chat/completionsagus/v1/messagesna torthaí a tugadh don mhúnla, agus ar/v1/chat/completionsmarcálannannotationsan áit a luann an freagra gach ceann acu. Insuite i Cuardach Gréasáin
- Nua
Ritheann
web_search: truear/v1/chat/completionsagus/v1/messagescuardach gréasáin sula bhfreagraíonn an múnla agus tugann sé na torthaí dó mar fhoinsí uimhrithe. Úsáideann iarratas a d'aimsigh torthaí aon chuardach amháin de do liúntas laethúil. Mura bhfuil aon cheann fágtha, freagraítear an t-iarratas gan chuardach. Insuite i Cuardach Gréasáin
- Seasta
Billeáiltear sruth a ghearrtar ar thaobh an fhreastalaí as an úsáid a tuairiscíodh go dtí an pointe sin. Filleann an chuid eile den áirithint ar d'iarmhéid.
- Seasta
Freagraíonn
shannon-coder-1ar/v1/responsesmar a dhéanann sé ar an dá chríochphointe eile. Uirlisí CLI códaithe - Seasta
Stopann eochair API rothlaithe ag obair láithreach.
- Nua
POST /v1/tokenizeagusPOST /v1/messages/count_tokens: comhaireamh token saor in aisce do na múnlaí open-weight óstáilte. Comhaireamh token - Nua
Cacheáil prompt ar na múnlaí open-weight óstáilte. Billeáiltear ionchur taiscthe ar 25% de phraghas an ionchuir agus tuairiscítear in
usageé ar na trí chríochphointe:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensaguscache_read_input_tokens. TuairiscíonnGET /v1/modelspricing.cached_input_per_million_usdaguscapabilities.prompt_cachingdo na múnlaí seo. Cacháil prompt - Seasta
Múnlaí open-weight óstáilte: tugann
tool_choiceéigeantach (requirednó feidhm ainmnithe) glao uirlise. Glaonna Feidhme - Seasta
Glacann múnlaí open-weight óstáilte le teachtaireacht
systemnach í an chéad teachtaireacht den chomhrá í.
- Nua
Tá an API inrochtana mar sheirbhís onion Tor agus ag seoladh I2P. Iompraíonn freagraí
api.shannon-ai.coman dá sheoladh sna ceanntáscaOnion-LocationagusX-I2P-Location. Críochphointí criptithe, Tor & I2P
- Nua
Múnlaí nua
shannon-3.1agusshannon-3.1-pro, liostaithe agGET /v1/models. Múnlaí agus praghsáil - Athraithe
Ritheann iarratas sruthaithe a dhícheanglaíonn a chliant go dtí a dheireadh agus comhairtear é. Roimhe seo, stop an freagra ag an dícheangal.
- Seasta
Le feiceáil sa logleabhar úsáide: iarratais chuig
/v1/responses.
- Nua
Cuireann múnlaí open-weight óstáilte na réimsí samplála i bhfeidhm:
temperature,top_p,seed,stopagusmax_tokensar/v1/chat/completions;temperature,top_pagusstop_sequencesar/v1/messages;temperature,top_pagusmax_output_tokensar/v1/responses. Chat Completions - Nua
Taispeánann an logleabhar úsáide costas in USD do gach glao agus mar iomlán.
- Briseadh
Freagraítear luach
modelnach id foilsithe é le400, an cineálinvalid_request_erroragus an teachtaireachtunknown model: <id>ar na trí chríochphointe. Roimhe seo, d'fhreagairshannon-1.6-liteiarratas den sórt sin. Múnlaí agus praghsáil - Briseadh
Ní ghlacann
/v1ach le heochair API. Ní léitear fianán síniú isteach an tsuímh ghréasáin ansin. Fíordheimhniú - Athraithe
Cosaint tuile: 120 iarratas in aghaidh an nóiméid in aghaidh an chuntais ar na trí chríochphointe giniúna. Teorainneacha agus iarmhéid
- Feabhsaithe
Nuair nach féidir leis an múnla freagairt, tá an teachtaireacht sheasta
The model backend failed to answer. Please retry.san earráid. Freagraítear seiceáil iarmhéid nach féidir a dhéanamh le503agus an cineálapi_error. Láimhseáil Earráide - Seasta
Tugann iarratas gan sruthú a theipeann a chur in áirithe ar ais d'iarmhéid.
- Nua
Tuairiscíonn
GET /v1/modelscapabilities.reasoning_effortdo gach múnla. Iarracht réasúnaíochta - Feabhsaithe
Múnlaí open-weight óstáilte: críochnaíonn iarratas gan sruthú nach bhfaigheann freagra le
504agus an cineálapi_error. Is502toradh folamh. Láimhseáil Earráide
- Briseadh
Glacann múnlaí open-weight óstáilte leis an ionchur a nglacann an múnla ainmnithe leis. Freagraítear íomhá a seoltar chuig id téacs amháin le
400agus<id> does not accept image input. Freagraítearresponse_formatar id gan aschur struchtúrtha le400. TuairiscíonnGET /v1/modelscapabilities.vision,response_formatagusjson_schemado gach id. Íomhánna agus comhaid - Seasta
Iompraíonn freagraí gan sruthú an téacs réasúnaíochta:
reasoning_contentar theachtaireacht/v1/chat/completions, agus blocthinkingroimh an téacs ar/v1/messages. Iarracht réasúnaíochta - Athraithe
Tá praghsanna nua ag múnlaí open-weight óstáilte, ó $0.50 in aghaidh gach 1M token ionchuir agus $2.00 in aghaidh gach 1M token aschuir. Múnlaí agus praghsáil
- Athraithe
Tá id amháin in aghaidh gach múnla ag múnlaí open-weight óstáilte, dhá id dhéag san iomlán. Múnlaí agus praghsáil
- Nua
Aschur struchtúrtha ar
shannon-3,shannon-3-pro,shannon-3.1agusshannon-3.1-pro. TuairiscíonnGET /v1/modelscapabilities.json_schema: truedóibh. Aschuir Struchtúrtha - Nua
Léann
/v1/responsestext.format(json_objectnójson_schema) le haghaidh aschuir struchtúrtha. Responses API - Seasta
Filleann
/v1/responsesréasúnaíocht na múnlaí Shannon: mír aschuirreasoningroimh an mírmessage, agus na himeachtaí sruthresponse.reasoning_summary_text.deltaagusresponse.reasoning_summary_text.done. Responses API - Seasta
Is é an id foilsithe an réimse
modelde fhreagra ar gach críochphointe. Támodelaguscreated_ati réad Responses. - Feabhsaithe
Tuairiscíonn
GET /v1/modelsfuinneog comhthéacs gach múnla. Múnlaí agus praghsáil
- Nua
Freagraíonn múnlaí open-weight óstáilte ar
/v1/messagesagus/v1/responseschomh maith le/v1/chat/completions, le do prompt córais agus glaonna uirlisí. Glacann/v1/messageslethinking, agus is réimse iarratais éreasoning_effort. Múnlaí agus praghsáil - Feabhsaithe
Leanann corp earráide ar
/v1cruthanna na SDKanna: réaderrorletypeagusmessagear na críochphointí i bhformáid OpenAI, agus an réad céanna laistigh de{"type": "error"}ar/v1/messages. Láimhseáil Earráide - Nua
Keep-alive ar shruthanna oscailte gach 15 soicind: líne tráchta
: pingar/v1/chat/completions,event: pingar/v1/messages. Sruthú - Athraithe
Tosaíonn ids glaonna uirlisí le
call_ar/v1/chat/completionsagus/v1/responses, agus letoolu_ar/v1/messages. Glaonna Feidhme - Briseadh
/v1/responses: is éfalseréamhshocrústream. Responses API - Nua
Glactar le
max_completion_tokensmar ainm eile armax_tokensar/v1/chat/completions. Chat Completions - Seasta
Tá an t-eagar
outputsan imeachtresponse.completedde shruth Responses. Responses API - Nua
Tá
display_name,context_window,max_output_tokens,pricing,capabilitiesagusendpointsin iontrálachaGET /v1/models. Múnlaí agus praghsáil - Nua
Tá
x-request-idi ngach freagra, agus seoltar luach a sheolann tú ar ais. Is féidir le coirp iarratais a bheith suas le 32 MiB. - Nua
Is féidir eochair a chúlghairm gan eochair nua a eisiúint. Tá an logleabhar úsáide leathanaithe.
- Nua
Íomhánna agus doiciméid in iarratais: codanna
image_urlar/v1/chat/completions, bloicimage,documentagusfilear/v1/messages, codannainput_imagear/v1/responses. Íomhánna agus comhaid - Nua
Múnla nua
shannon-3-pro. Múnlaí agus praghsáil
- Nua
Múnla nua
shannon-3. Múnlaí agus praghsáil - Nua
Iompraíonn sruthanna ar
/v1/chat/completionsan réasúnaíocht mardelta.reasoning_content. Iarracht réasúnaíochta
- Athraithe
Coinnítear
max_tokenslaistigh de 1 go 65,536. Tugtar luach lasmuigh den raon sin chuig an gcuid is gaire dá cheann, ní dhiúltaítear dó. Chat Completions
- Nua
Comhairtear
shannon-coder-1i nglaonna in aghaidh an phlean ar/v1/chat/completionsagus/v1/messages. Nuair a úsáidtear glaonna fuinneoige go léir, is é429an freagra leis an teachtaireachtShannon Coder call quota reached. Uirlisí CLI códaithe - Nua
Freagraítear comhrá is mó ná an fhuinneog comhthéacs le
400, an cineálinvalid_request_erroragus an códcontext_length_exceeded. Tagann earráid laistigh de shruth mar imeacht earráide, ní mar théacs sa fhreagra. Uirlisí CLI códaithe
- Nua
Na críochphointí
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesagusGET /v1/models. Is iad na críochphointí a ghlaonn SDKanna OpenAI agus Anthropic, Claude Code agus Codex CLI. Forbhreathnú - Nua
Glaonna uirlisí le
toolsar/v1/chat/completionsagus/v1/messages, aschur struchtúrtha leresponse_format, agussystemmar shreang nó mar bhloic téacs ar/v1/messages. Glaonna Feidhme
- Nua
Ids múnla
shannon-1.6-pro,shannon-2-lite,shannon-2-proagusshannon-coder-1, in aice leshannon-1.6-lite. Múnlaí agus praghsáil
- Nua
An chéad eisiúint den API: comhrá i bhformáid OpenAI agus i bhformáid Anthropic, agus críochphointe Responses, gach ceann acu á ghlaoch le heochair API a thosaíonn le
sk-. Fíordheimhniú