Àkọsílẹ̀ àwọn àyípadà
Awọn imudojuiwọn aipẹ ati awọn ilọsiwaju si Shannon API.
Ojú-ìwé yìí ń ṣàkójọ àwọn àyípadà tí o lè rí gẹ́gẹ́ bí ẹni tó ń pe API náà: endpoint, field àti model tuntun, ìhùwàsí tó yípadà àti àwọn àtúnṣe. Àwọn tuntun jùlọ ni ó wà ní iwájú. Ohun kọ̀ọ̀kan ń gbé ọjọ́ tí a ṣe àyípadà náà wá.
Ohun tí a fi Breaking sàmì sí lè yí àbájáde ìbéèrè tó ti ṣiṣẹ́ tẹ́lẹ̀ padà. API náà ní ẹ̀yà kan ṣoṣo, /v1, nítorí náà a ṣàkójọ àwọn àyípadà ní ọjọ́ kì í ṣe ní nọ́ńbà ẹ̀yà.
- Tuntun
Ìbéèrè tó ní
web_search: truedárúkọ àwọn orísun rẹ̀:sourceslórí/v1/chat/completionsàti/v1/messagesṣe àtòjọ àwọn abajade tí a fún model, àti lórí/v1/chat/completions,annotationsṣàmì ibi tí ìdáhùn ti tọ́ka sí kọ̀ọ̀kan. Iwadi Wẹẹbu ti a ṣe sinu
- Tuntun
web_search: truelórí/v1/chat/completionsàti/v1/messagesń ṣe ìwá orí wẹ́ẹ̀bù kí model tó dáhùn, ó sì fún un ní àbájáde gẹ́gẹ́ bí orísun tí a ṣe nọ́ńbà. Ìbéèrè tó rí àbájáde ń lo ìwá kan nínú allowance ojoojúmọ́ rẹ. Bí kò bá ṣẹ́kù kankan, a ó dá ìbéèrè náà lóhùn láìsí ìwá. Iwadi Wẹẹbu ti a ṣe sinu
- Ti o wa titi
Stream tí server gé kúrò ni a ń gba owó rẹ̀ fún ìlò tí a ròyìn títí dé ibi yẹn. Ìyókù ohun tí a fi pamọ́ ń padà sí balance rẹ.
- Ti o wa titi
shannon-coder-1ń dáhùn lórí/v1/responsesbí ó ṣe ń dáhùn lórí endpoint méjèèjì yòókù. Àwọn irinṣẹ́ CLI fún kíkọ code - Ti o wa titi
API key tí a pààrọ̀ ń dáwọ́ iṣẹ́ dúró lẹ́sẹ̀kẹsẹ̀.
- Tuntun
POST /v1/tokenizeàtiPOST /v1/messages/count_tokens: ìkà token lọ́fẹ̀ẹ́ fún àwọn model open-weight tí a gbàlejò. Kíka token - Tuntun
Prompt caching lórí àwọn model open-weight tí a gbàlejò. A ń gba owó input tí a fi pamọ́ ní 25% iye owó input, a sì ń sọ ọ́ nínú
usagelórí endpoint mẹ́tẹ̀ẹ̀ta:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensàticache_read_input_tokens.GET /v1/modelsń sọpricing.cached_input_per_million_usdàticapabilities.prompt_cachingfún àwọn model wọ̀nyí. Caching prompt - Ti o wa titi
Àwọn model open-weight tí a gbàlejò:
tool_choicetí a fipá mú (requiredtàbí function tí a dárúkọ) ń mú ìpè tool jáde. Ipe iṣẹ - Ti o wa titi
Àwọn model open-weight tí a gbàlejò ń gba ìfiránṣẹ́
systemtí kì í ṣe ìfiránṣẹ́ àkọ́kọ́ nínú ìjíròrò.
- Tuntun
A lè dé API náà gẹ́gẹ́ bí onion service Tor àti ní àdírẹ́sì I2P. Àwọn èsì
api.shannon-ai.comń gbé àdírẹ́sì méjèèjì wá nínú headerOnion-LocationàtiX-I2P-Location. Àwọn endpoint onídìpọ̀, Tor àti I2P
- Tuntun
Àwọn model tuntun
shannon-3.1àtishannon-3.1-pro, tíGET /v1/modelsń kọ sílẹ̀. Àwọn model àti iye owó - Ti yípadà
Ìbéèrè streaming tí client rẹ̀ já asopọ̀ ń bá a lọ títí dé ìparí, a sì ń kà á. Tẹ́lẹ̀, ìdáhùn máa ń dúró nígbà tí asopọ̀ bá já.
- Ti o wa titi
Àwọn ìbéèrè sí
/v1/responsesń hàn nínú àkọsílẹ̀ ìlò.
- Tuntun
Àwọn model open-weight tí a gbàlejò ń lo àwọn field sampling:
temperature,top_p,seed,stopàtimax_tokenslórí/v1/chat/completions;temperature,top_pàtistop_sequenceslórí/v1/messages;temperature,top_pàtimax_output_tokenslórí/v1/responses. Chat Completions - Tuntun
Àkọsílẹ̀ ìlò ń fi iye owó ní USD hàn fún ìpè kọ̀ọ̀kan àti gẹ́gẹ́ bí àpapọ̀.
- Fifọ
Iye
modeltí kì í ṣe id tí a tẹ̀jáde ni a ń fi400, irúinvalid_request_erroràti ìfiránṣẹ́unknown model: <id>dá lóhùn lórí gbogbo endpoint mẹ́tẹ̀ẹ̀ta. Tẹ́lẹ̀,shannon-1.6-liteni ó ń dáhùn ìbéèrè bẹ́ẹ̀. Àwọn model àti iye owó - Fifọ
/v1ń gba API key nìkan. A kì í ka cookie ìwọlé ti wẹ́ẹ̀bù ibẹ̀. Ijeri - Ti yípadà
Ààbò flood: ìbéèrè 120 ní ìṣẹ́jú kan fún account kọ̀ọ̀kan lórí endpoint ìṣẹ̀dá mẹ́tẹ̀ẹ̀ta. Àwọn ààlà àti balance
- Imudara
Nígbà tí model kò bá lè dáhùn, àṣìṣe náà ń gbé ìfiránṣẹ́ tí kì í yípadà wá:
The model backend failed to answer. Please retry.Àyẹ̀wò balance tí a kò lè ṣe ni a ń fi503àti irúapi_errordá lóhùn. Mimu Aṣiṣe - Ti o wa titi
Ìbéèrè tí kì í ṣe streaming tó kùnà ń dá ohun tí a fi pamọ́ padà sí balance rẹ.
- Tuntun
GET /v1/modelsń sọcapabilities.reasoning_effortfún model kọ̀ọ̀kan. Ipa ìrònú - Imudara
Àwọn model open-weight tí a gbàlejò: ìbéèrè tí kì í ṣe streaming tí kò rí ìdáhùn máa ń parí pẹ̀lú
504àti irúapi_error. Àbájáde òfo jẹ́502. Mimu Aṣiṣe
- Fifọ
Àwọn model open-weight tí a gbàlejò ń gba input tí model tí a dárúkọ ń gbà. Àwòrán tí a fi ránṣẹ́ sí id text-only ni a ń fi
400àti<id> does not accept image inputdá lóhùn.response_formatlórí id tí kò ní structured output ni a ń fi400dá lóhùn.GET /v1/modelsń sọcapabilities.vision,response_formatàtijson_schemafún id kọ̀ọ̀kan. Àwọn àwòrán àti fáìlì - Ti o wa titi
Àwọn èsì tí kì í ṣe streaming ń gbé ọ̀rọ̀ ìrònú wá:
reasoning_contentlórí ìfiránṣẹ́/v1/chat/completions, àti blockthinkingṣáájú text lórí/v1/messages. Ipa ìrònú - Ti yípadà
Àwọn model open-weight tí a gbàlejò ní iye owó tuntun, láti $0.50 fún input token 1M àti $2.00 fún output token 1M. Àwọn model àti iye owó
- Ti yípadà
Àwọn model open-weight tí a gbàlejò ní id kan fún model kọ̀ọ̀kan, id méjìlá lápapọ̀. Àwọn model àti iye owó
- Tuntun
Structured output lórí
shannon-3,shannon-3-pro,shannon-3.1àtishannon-3.1-pro.GET /v1/modelsń sọcapabilities.json_schema: truefún wọn. Awọn igbejade ti a ṣeto - Tuntun
/v1/responsesń katext.format(json_objecttàbíjson_schema) fún structured output. Responses API - Ti o wa titi
/v1/responsesń dá ìrònú àwọn model Shannon padà: ohun inú outputreasoningṣáájú ohunmessage, àti àwọn event streamresponse.reasoning_summary_text.deltaàtiresponse.reasoning_summary_text.done. Responses API - Ti o wa titi
Field
modelti èsì jẹ́ id tí a tẹ̀jáde lórí gbogbo endpoint. Object Responses ń gbémodelàticreated_atwá. - Imudara
GET /v1/modelsń sọ context window ti model kọ̀ọ̀kan. Àwọn model àti iye owó
- Tuntun
Àwọn model open-weight tí a gbàlejò ń dáhùn lórí
/v1/messagesàti/v1/responsesbákan náà bí lórí/v1/chat/completions, pẹ̀lú system prompt rẹ àti àwọn ìpè tool./v1/messagesń gbathinking,reasoning_effortsì jẹ́ field inú ìbéèrè. Àwọn model àti iye owó - Imudara
Body àṣìṣe lórí
/v1tẹ̀lé ìrísí SDK: objecterrorpẹ̀lútypeàtimessagelórí àwọn endpoint ọ̀nà OpenAI, àti object kan náà nínú{"type": "error"}lórí/v1/messages. Mimu Aṣiṣe - Tuntun
Keep-alive lórí àwọn stream tó ṣí ní gbogbo ìṣẹ́jú-aaya 15: ìlà ọ̀rọ̀ àlàyé
: pinglórí/v1/chat/completions,event: pinglórí/v1/messages. Sisanwọle - Ti yípadà
Id ìpè tool bẹ̀rẹ̀ pẹ̀lú
call_lórí/v1/chat/completionsàti/v1/responses, àti pẹ̀lútoolu_lórí/v1/messages. Ipe iṣẹ - Fifọ
/v1/responses: iye àtìbẹ̀rẹ̀streamjẹ́false. Responses API - Tuntun
A gba
max_completion_tokensgẹ́gẹ́ bí orúkọ mìíràn fúnmax_tokenslórí/v1/chat/completions. Chat Completions - Ti o wa titi
Event
response.completedti stream Responses ń gbé arrayoutputwá. Responses API - Tuntun
Àwọn ohun inú
GET /v1/modelsń gbédisplay_name,context_window,max_output_tokens,pricing,capabilitiesàtiendpointswá. Àwọn model àti iye owó - Tuntun
Gbogbo èsì ń gbé
x-request-idwá, a sì ń dá iye tí o fi ránṣẹ́ padà. Body ìbéèrè lè tó 32 MiB. - Tuntun
A lè wọ́gi lé key láì fún ni ní tuntun. A pín àkọsílẹ̀ ìlò sí àwọn ojú-ìwé.
- Tuntun
Àwòrán àti ìwé àkọsílẹ̀ nínú àwọn ìbéèrè: àwọn part
image_urllórí/v1/chat/completions, àwọn blockimage,documentàtifilelórí/v1/messages, àwọn partinput_imagelórí/v1/responses. Àwọn àwòrán àti fáìlì - Tuntun
Model tuntun
shannon-3-pro. Àwọn model àti iye owó
- Tuntun
Model tuntun
shannon-3. Àwọn model àti iye owó - Tuntun
Àwọn stream lórí
/v1/chat/completionsń gbé ìrònú wá gẹ́gẹ́ bídelta.reasoning_content. Ipa ìrònú
- Ti yípadà
A pa
max_tokensmọ́ láàárín 1 sí 65,536. Iye tó bá wà lóde ààlà yẹn ni a ń gbé wá sí ìkangun tó súnmọ́ jùlọ, a kì í kọ̀ ọ́. Chat Completions
- Tuntun
A ń ka
shannon-coder-1ní ìpè fún plan kọ̀ọ̀kan lórí/v1/chat/completionsàti/v1/messages. Nígbà tí ìpè ferese kan bá tán, èsì jẹ́429pẹ̀lú ìfiránṣẹ́Shannon Coder call quota reached. Àwọn irinṣẹ́ CLI fún kíkọ code - Tuntun
Ìjíròrò tó tóbi ju context window lọ ni a ń fi
400dá lóhùn, pẹ̀lú irúinvalid_request_erroràti codecontext_length_exceeded. Àṣìṣe inú stream máa ń dé gẹ́gẹ́ bí error event, kì í ṣe gẹ́gẹ́ bí ọ̀rọ̀ inú ìdáhùn. Àwọn irinṣẹ́ CLI fún kíkọ code
- Tuntun
Àwọn endpoint
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesàtiGET /v1/models. Àwọn ni endpoint tí àwọn SDK OpenAI àti Anthropic, Claude Code àti Codex CLI ń pè. Akopọ - Tuntun
Ìpè tool pẹ̀lú
toolslórí/v1/chat/completionsàti/v1/messages, structured output pẹ̀lúresponse_format, àtisystemgẹ́gẹ́ bí string tàbí gẹ́gẹ́ bí àwọn block text lórí/v1/messages. Ipe iṣẹ
- Tuntun
Àwọn id model
shannon-1.6-pro,shannon-2-lite,shannon-2-proàtishannon-coder-1, lẹ́gbẹ̀ẹ́shannon-1.6-lite. Àwọn model àti iye owó
- Tuntun
Ìtújáde àkọ́kọ́ ti API náà: chat ní ọ̀nà OpenAI àti ní ọ̀nà Anthropic, àti endpoint Responses, tí a ń pè kọ̀ọ̀kan pẹ̀lú API key tó bẹ̀rẹ̀ pẹ̀lú
sk-. Ijeri