Canji
Sabunta kwanan nan da haɓakawa ga Shannon API.
Wannan shafin yana lissafa canje-canjen da za ku iya gani a matsayin mai kiran API: sabbin endpoints, fields da models, canjin hali da gyare-gyare. Sabbin shigarwa suna farko. Kowace shigarwa tana ɗauke da ranar da aka yi canjin.
Shigarwar da aka yiwa alama Karyewa na iya canza sakamakon request da ya yi aiki a baya. API yana da sigar ɗaya, /v1, don haka ana lissafa canje-canje ta kwanan wata ba ta lambar sigar ba.
- Sabo
Request mai
web_search: trueyana ambaton tushensa:sourcesa/v1/chat/completionsda/v1/messagesyana jera sakamakon da aka ba model, kuma a/v1/chat/completionsannotationsyana nuna inda amsar ta ambaci kowanne. Binciken Yanar Gizon da aka Gina
- Sabo
web_search: truea/v1/chat/completionsda/v1/messagesyana gudanar da binciken yanar gizo kafin model ya amsa kuma yana ba shi sakamakon a matsayin tushe masu lamba. Request da ya sami sakamako yana amfani da bincike ɗaya na allowance ɗinku na yau da kullun. Idan babu sauran, ana amsa request ba tare da bincike ba. Binciken Yanar Gizon da aka Gina
- Kafaffen
Stream da aka yanke a gefen server ana cajin sa don usage da aka bayyana har wannan lokacin. Sauran abin da aka ware yana komawa balance ɗinku.
- Kafaffen
shannon-coder-1yana amsawa a/v1/responseskamar yadda yake yi a sauran endpoints biyu. Kayan CLI na rubuta code - Kafaffen
Maɓallin API da aka canza yana daina aiki nan take.
- Sabo
POST /v1/tokenizedaPOST /v1/messages/count_tokens: ƙirgan tokens kyauta ga hosted open-weight models. Ƙidayar tokens - Sabo
Adana prompt a hosted open-weight models. Ana cajin cached input a 25% na farashin input kuma ana bayyana shi a
usagea dukkan endpoints uku:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensdacache_read_input_tokens.GET /v1/modelsyana bayyanapricing.cached_input_per_million_usddacapabilities.prompt_cachingga waɗannan models. Adana prompt - Kafaffen
Hosted open-weight models:
tool_choicena tilas (requiredko function mai suna) yana samar da kiran tool. Kiran Aiki - Kafaffen
Hosted open-weight models suna karɓar saƙon
systemwanda ba shi ne saƙon farko na tattaunawa ba.
- Sabo
Ana iya isa API a matsayin Tor onion service da kuma a adireshin I2P. Amsoshin
api.shannon-ai.comsuna ɗauke da adireshin biyu a headersOnion-LocationdaX-I2P-Location. Endpoints masu ɓoyewa, Tor & I2P
- Sabo
Sabbin models
shannon-3.1dashannon-3.1-pro, daGET /v1/modelske lissafawa. Models & farashi - An canza
Request da aka yi streaming wanda client ɗinsa ya katse yana ci gaba har ƙarshe kuma ana ƙirga shi. A da, amsar tana tsayawa a lokacin katsewa.
- Kafaffen
Requests zuwa
/v1/responsessuna bayyana a usage log.
- Sabo
Hosted open-weight models suna aiwatar da sampling fields:
temperature,top_p,seed,stopdamax_tokensa/v1/chat/completions;temperature,top_pdastop_sequencesa/v1/messages;temperature,top_pdamax_output_tokensa/v1/responses. Chat Completions - Sabo
Usage log yana nuna kuɗi a USD ga kowane kira da kuma jimilla.
- Karyewa
Ƙimar
modelda ba id da aka wallafa ba ana amsa ta da400, nau'ininvalid_request_errorda saƙonunknown model: <id>a dukkan endpoints uku. A da,shannon-1.6-litene yake amsa irin wannan request. Models & farashi - Karyewa
/v1yana karɓar maɓallin API kaɗai. Ba a karanta cookie na shiga na gidan yanar gizo a can. Tabbatarwa - An canza
Flood protection: requests 120 a minti ɗaya ga kowane asusu a endpoints uku na samarwa. Iyakoki da balance
- Inganta
Idan model ya kasa amsawa, kuskuren yana ɗauke da tsayayyen saƙo
The model backend failed to answer. Please retry.Duba balance da ba za a iya yi ba ana amsa shi da503da nau'inapi_error. Kuskuren Gudanarwa - Kafaffen
Request da ba a yi streaming ba kuma ya gaza yana mayar da abin da aka ware zuwa balance ɗinku.
- Sabo
GET /v1/modelsyana bayyanacapabilities.reasoning_effortga kowane model. Reasoning effort - Inganta
Hosted open-weight models: request da ba a yi streaming ba wanda bai samu amsa ba yana ƙarewa da
504da nau'inapi_error. Sakamako mara komai shi ne502. Kuskuren Gudanarwa
- Karyewa
Hosted open-weight models suna karɓar input da model mai suna yake karɓa. Hoto da aka aika zuwa id na rubutu kaɗai ana amsa shi da
400da<id> does not accept image input.response_formata kan id ba tare da structured output ba ana amsa shi da400.GET /v1/modelsyana bayyanacapabilities.vision,response_formatdajson_schemaga kowane id. Hotuna da fayiloli - Kafaffen
Amsoshin da ba a yi streaming ba suna ɗauke da rubutun reasoning:
reasoning_contenta saƙon/v1/chat/completions, da block nathinkingkafin rubutu a/v1/messages. Reasoning effort - An canza
Hosted open-weight models suna da sabbin farashi, daga $0.50 kowace 1M input tokens da $2.00 kowace 1M output tokens. Models & farashi
- An canza
Hosted open-weight models suna da id ɗaya ga kowane model, ids goma sha biyu gaba ɗaya. Models & farashi
- Sabo
Structured output a
shannon-3,shannon-3-pro,shannon-3.1dashannon-3.1-pro.GET /v1/modelsyana bayyanacapabilities.json_schema: truea gare su. Abubuwan da aka Tsara - Sabo
/v1/responsesyana karantatext.format(json_objectkojson_schema) don structured output. Responses API - Kafaffen
/v1/responsesyana mayar da reasoning na models na Shannon: item na outputreasoningkafin item namessage, da stream eventsresponse.reasoning_summary_text.deltadaresponse.reasoning_summary_text.done. Responses API - Kafaffen
Field ɗin
modelna amsa shi ne id da aka wallafa a kowane endpoint. Object na Responses yana ɗauke damodeldacreated_at. - Inganta
GET /v1/modelsyana bayyana context window na kowane model. Models & farashi
- Sabo
Hosted open-weight models suna amsawa a
/v1/messagesda/v1/responsesban da/v1/chat/completions, da system prompt ɗinku da kiran tool./v1/messagesyana karɓarthinking, kumareasoning_effortfield ne na request. Models & farashi - Inganta
Jikunan kurakurai a
/v1suna bin siffofin SDK: object ɗinerrormaitypedamessagea endpoints na tsarin OpenAI, da object iri ɗaya a cikin{"type": "error"}a/v1/messages. Kuskuren Gudanarwa - Sabo
Keep-alive a buɗaɗɗun streams kowane daƙiƙa 15: layin sharhi
: pinga/v1/chat/completions, daevent: pinga/v1/messages. Yawo - An canza
Ids na kiran tool suna farawa da
call_a/v1/chat/completionsda/v1/responses, datoolu_a/v1/messages. Kiran Aiki - Karyewa
/v1/responses:streamna asali shi nefalse. Responses API - Sabo
Ana karɓar
max_completion_tokensa matsayin wani suna namax_tokensa/v1/chat/completions. Chat Completions - Kafaffen
Event
response.completedna Responses stream yana ɗauke da array ɗinoutput. Responses API - Sabo
Shigarwar
GET /v1/modelstana ɗauke dadisplay_name,context_window,max_output_tokens,pricing,capabilitiesdaendpoints. Models & farashi - Sabo
Kowace amsa tana ɗauke da
x-request-id, kuma ƙimar da kuka aika ana mayar da ita. Jikunan requests na iya kaiwa 32 MiB. - Sabo
Ana iya soke maɓalli ba tare da an ba da sabo ba. An raba usage log zuwa shafuka.
- Sabo
Hotuna da takardu a requests: sassan
image_urla/v1/chat/completions, blocks naimage,documentdafilea/v1/messages, sassaninput_imagea/v1/responses. Hotuna da fayiloli - Sabo
Sabon model
shannon-3-pro. Models & farashi
- Sabo
Sabon model
shannon-3. Models & farashi - Sabo
Streams a
/v1/chat/completionssuna ɗauke da reasoning a matsayindelta.reasoning_content. Reasoning effort
- An canza
Ana riƙe
max_tokenstsakanin 1 zuwa 65,536. Ƙimar da ta wuce wannan kewayon ana kawo ta zuwa mafi kusa, ba a ƙi ta ba. Chat Completions
- Sabo
Ana ƙirga
shannon-coder-1a kira ga kowane plan a/v1/chat/completionsda/v1/messages. Idan an gama kiran taga, amsar429ce da saƙonShannon Coder call quota reached. Kayan CLI na rubuta code - Sabo
Tattaunawar da ta fi context window girma ana amsa ta da
400, nau'ininvalid_request_errorda codecontext_length_exceeded. Kuskuren da ya faru a cikin stream yana zuwa a matsayin error event, ba a matsayin rubutu a cikin amsar ba. Kayan CLI na rubuta code
- Sabo
Endpoints na
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesdaGET /v1/models. Su ne endpoints da OpenAI da Anthropic SDKs, Claude Code da Codex CLI ke kira. Dubawa - Sabo
Kiran tool da
toolsa/v1/chat/completionsda/v1/messages, structured output daresponse_format, dasystema matsayin string ko text blocks a/v1/messages. Kiran Aiki
- Sabo
Model ids
shannon-1.6-pro,shannon-2-lite,shannon-2-prodashannon-coder-1, kusa dashannon-1.6-lite. Models & farashi
- Sabo
Fitowar API ta farko: taɗi a tsarin OpenAI da tsarin Anthropic, da endpoint na Responses, kowanne ana kiransa da maɓallin API da ya fara da
sk-. Tabbatarwa