Mbiri ya kusintha
Zosintha zaposachedwa ndi kukonza kwa Shannon API.
Tsamba ili limalemba zosintha zomwe mungathe kuziona ngati wogwiritsa ntchito API: ma endpoint, ma field ndi ma model atsopano, khalidwe losinthidwa ndi zokonza. Zolemba zatsopano zimabwera poyamba. Cholemba chilichonse chili ndi tsiku lomwe kusinthako kunachitika.
Entry yolembedwa Yophwanya ikhoza kusintha zotsatira za pempho lomwe linkagwira ntchito kale. API ili ndi version imodzi, /v1, choncho zosintha zalembedwa ndi tsiku, osati ndi nambala ya version.
- Chatsopano
Pempho lokhala ndi
web_search: truelimatchula magwero ake:sourcespa/v1/chat/completionsndi/v1/messagesimalemba zotsatira zomwe model idapatsidwa, ndipo pa/v1/chat/completionsannotationsimasonyeza pomwe yankho limatchula chilichonse. Kusaka pa web
- Chatsopano
web_search: truepa/v1/chat/completionsndi/v1/messagesimasaka pa web model isanayankhe ndipo imapereka zotsatira ngati magwero owerengedwa. Pempho lomwe lapeza zotsatira limagwiritsa ntchito kusaka kumodzi kwa allowance yanu ya tsiku. Ngati palibe chotsalira, pempho limayankhidwa popanda kusaka. Kusaka pa web
- Zakonzedwa
Stream yomwe yadulidwa kumbali ya server imaperekedwa mtengo wa usage yomwe yanenedwa mpaka pamenepo. Zotsalira za reservation zimabwerera ku balance yanu.
- Zakonzedwa
shannon-coder-1imayankha pa/v1/responsesmonga momwe imachitira pa ma endpoint ena awiri. Zida za CLI zolembera code - Zakonzedwa
API key yosinthidwa imasiya kugwira ntchito nthawi yomweyo.
- Chatsopano
POST /v1/tokenizendiPOST /v1/messages/count_tokens: kuwerenga ma token kwaulere pa hosted open-weight model. Kuwerenga ma token - Chatsopano
Prompt caching pa hosted open-weight model. Input yosungidwa imaperekedwa mtengo wa 25% ya mtengo wa input ndipo imanenedwa mu
usagepa ma endpoint onse atatu:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensndicache_read_input_tokens.GET /v1/modelsimanenapricing.cached_input_per_million_usdndicapabilities.prompt_cachingpa ma model awa. Kusunga prompt - Zakonzedwa
Hosted open-weight model:
tool_choiceyokakamiza (requiredkapena function yotchulidwa) imabweretsa call ya tool. Kuyitana mafunkseni - Zakonzedwa
Hosted open-weight model zimalandira message ya
systemyomwe si message yoyamba ya zokambirana.
- Chatsopano
API imapezeka ngati Tor onion service komanso pa adilesi ya I2P. Mayankho a
api.shannon-ai.comamanyamula ma adilesi onse awiri mu ma header aOnion-LocationndiX-I2P-Location. Ma endpoint obisika, Tor & I2P
- Chatsopano
Ma model atsopano
shannon-3.1ndishannon-3.1-pro, olembedwa ndiGET /v1/models. Ma model ndi mitengo - Zasinthidwa
Pempho la stream lomwe client yake yadula limapitirira mpaka kumapeto ndipo limawerengedwa. Kale, yankho linkaima pa kudula.
- Zakonzedwa
Ma pempho a
/v1/responsesamaoneka mu usage log.
- Chatsopano
Hosted open-weight model zimagwiritsa ntchito ma sampling field:
temperature,top_p,seed,stopndimax_tokenspa/v1/chat/completions;temperature,top_pndistop_sequencespa/v1/messages;temperature,top_pndimax_output_tokenspa/v1/responses. Chat Completions - Chatsopano
Usage log imaonetsa mtengo mu USD pa call iliyonse komanso ngati chiwerengero chonse.
- Yophwanya
Mtengo wa
modelwomwe si id yofalitsidwa umayankhidwa ndi400, typeinvalid_request_errorndi messageunknown model: <id>pa ma endpoint onse atatu. Kale, pempho loterolo linkayankhidwa ndishannon-1.6-lite. Ma model ndi mitengo - Yophwanya
/v1imalandira API key yokha. Cookie yolowera ya webusaiti siiwerengedwa kumeneko. Kutsimikizira - Zasinthidwa
Flood protection: ma pempho 120 pa mphindi pa akaunti pa ma endpoint atatu opanga. Malire ndi balance
- Zasintha
Model ikalephera kuyankha, cholakwika chimanyamula message yokhazikika
The model backend failed to answer. Please retry.Kuyang'ana balance komwe sikungatheke kumayankhidwa ndi503ndi typeapi_error. Zolakwika - Zakonzedwa
Pempho losachita stream lomwe lalephera limabweza reservation yake ku balance yanu.
- Chatsopano
GET /v1/modelsimanenacapabilities.reasoning_effortpa model iliyonse. Reasoning effort - Zasintha
Hosted open-weight model: pempho losachita stream lomwe silinalandire yankho limatha ndi
504ndi typeapi_error. Zotsatira zopanda kanthu ndi502. Zolakwika
- Yophwanya
Hosted open-weight model zimalandira input yomwe model yotchulidwa imalandira. Chithunzi chotumizidwa ku id ya text yokha chimayankhidwa ndi
400ndi<id> does not accept image input.response_formatpa id yopanda structured output imayankhidwa ndi400.GET /v1/modelsimanenacapabilities.vision,response_formatndijson_schemapa id iliyonse. Zithunzi ndi ma file - Zakonzedwa
Mayankho osachita stream amanyamula text ya reasoning:
reasoning_contentpa message ya/v1/chat/completions, ndi block yathinkingpatsogolo pa text pa/v1/messages. Reasoning effort - Zasinthidwa
Hosted open-weight model zili ndi mitengo yatsopano, kuyambira pa $0.50 pa ma token 1M a input ndi $2.00 pa ma token 1M a output. Ma model ndi mitengo
- Zasinthidwa
Hosted open-weight model zili ndi id imodzi pa model iliyonse, ma id khumi ndi awiri onse. Ma model ndi mitengo
- Chatsopano
Structured output pa
shannon-3,shannon-3-pro,shannon-3.1ndishannon-3.1-pro.GET /v1/modelsimanenacapabilities.json_schema: truepa izo. Zotuluka zokonzedwa - Chatsopano
/v1/responsesimawerengatext.format(json_objectkapenajson_schema) pa structured output. Responses API - Zakonzedwa
/v1/responsesimabweza reasoning ya ma model a Shannon: item ya output yareasoningpatsogolo pa item yamessage, ndi ma event a streamresponse.reasoning_summary_text.deltandiresponse.reasoning_summary_text.done. Responses API - Zakonzedwa
Field ya
modelya yankho ndi id yofalitsidwa pa endpoint iliyonse. Object ya Responses imanyamulamodelndicreated_at. - Zasintha
GET /v1/modelsimanena context window ya model iliyonse. Ma model ndi mitengo
- Chatsopano
Hosted open-weight model zimayankha pa
/v1/messagesndi/v1/responseskomanso pa/v1/chat/completions, ndi system prompt yanu ndi ma call a tool./v1/messagesimalandirathinking, ndiporeasoning_effortndi field ya pempho. Ma model ndi mitengo - Zasintha
Ma body a zolakwika pa
/v1amatsatira mawonekedwe a SDK: object yaerroryokhala nditypendimessagepa ma endpoint a mtundu wa OpenAI, ndi object yomweyo mkati mwa{"type": "error"}pa/v1/messages. Zolakwika - Chatsopano
Keep-alive pa ma stream otseguka masekondi 15 aliwonse: mzere wa comment
: pingpa/v1/chat/completions,event: pingpa/v1/messages. Kutsitsa nthawi yeniyeni - Zasinthidwa
Ma id a call a tool amayamba ndi
call_pa/v1/chat/completionsndi/v1/responses, nditoolu_pa/v1/messages. Kuyitana mafunkseni - Yophwanya
/v1/responses:streamndifalsemwa default. Responses API - Chatsopano
max_completion_tokensimalandiridwa ngati dzina lina lamax_tokenspa/v1/chat/completions. Chat Completions - Zakonzedwa
Event ya
response.completedya stream ya Responses imanyamula array yaoutput. Responses API - Chatsopano
Ma entry a
GET /v1/modelsamanyamuladisplay_name,context_window,max_output_tokens,pricing,capabilitiesndiendpoints. Ma model ndi mitengo - Chatsopano
Yankho lililonse limanyamula
x-request-id, ndipo mtengo womwe mutumiza umabwezedwa. Ma body a pempho akhoza kufika 32 MiB. - Chatsopano
Kiyi ikhoza kuthetsedwa popanda kupatsidwa yatsopano. Usage log imagawidwa m'masamba.
- Chatsopano
Zithunzi ndi zikalata m'ma pempho: ma part a
image_urlpa/v1/chat/completions, ma block aimage,documentndifilepa/v1/messages, ma part ainput_imagepa/v1/responses. Zithunzi ndi ma file - Chatsopano
Model yatsopano
shannon-3-pro. Ma model ndi mitengo
- Chatsopano
Model yatsopano
shannon-3. Ma model ndi mitengo - Chatsopano
Ma stream a
/v1/chat/completionsamanyamula reasoning ngatidelta.reasoning_content. Reasoning effort
- Zasinthidwa
max_tokensimasungidwa pakati pa 1 ndi 65,536. Mtengo wopitirira malirewo umasunthidwa kumapeto apafupi, osakanidwa. Chat Completions
- Chatsopano
shannon-coder-1imawerengedwa m'ma call pa plan pa/v1/chat/completionsndi/v1/messages. Ma call a window akatha, yankho limakhala429ndi messageShannon Coder call quota reached. Zida za CLI zolembera code - Chatsopano
Zokambirana zazikulu kuposa context window zimayankhidwa ndi
400, typeinvalid_request_errorndi codecontext_length_exceeded. Cholakwika mkati mwa stream chimafika ngati event ya error, osati ngati text mu yankho. Zida za CLI zolembera code
- Chatsopano
Ma endpoint a
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesndiGET /v1/models. Ndi ma endpoint omwe ma OpenAI ndi Anthropic SDK, Claude Code ndi Codex CLI amaitana. Chidule - Chatsopano
Ma call a tool ndi
toolspa/v1/chat/completionsndi/v1/messages, structured output ndiresponse_format, ndisystemngati string kapena ma text block pa/v1/messages. Kuyitana mafunkseni
- Chatsopano
Ma model id
shannon-1.6-pro,shannon-2-lite,shannon-2-prondishannon-coder-1, pambali pashannon-1.6-lite. Ma model ndi mitengo
- Chatsopano
Kutulutsidwa koyamba kwa API: chat mu mtundu wa OpenAI ndi mu mtundu wa Anthropic, ndi endpoint ya Responses, iliyonse imaitanidwa ndi API key yoyambira ndi
sk-. Kutsimikizira