Rekoto ya diphetoho
Dintlafatso le ntlafatso tsa moraorao tsa Shannon API.
Leqephe lena le thathamisa liphetoho tseo u ka li bonang u le moletsi oa API: li-endpoint, li-field le li-model tse ncha, boitšoaro bo fetotsoeng le litokiso. Li-entry tse ncha ka ho fetisisa li tla pele. Entry e 'ngoe le e 'ngoe e na le letsatsi leo phetoho e entsoeng ka lona.
Entry e tšoailoeng E robehileng e ka fetola sephetho sa kopo e kileng ea sebetsa pele. API e na le mofuta o le mong, /v1, kahoo liphetoho li thathamisitsoe ka letsatsi eseng ka nomoro ea mofuta.
- Ntjha
Kopo e nang le
web_search: truee reha mehloli ea eona:sourcesho/v1/chat/completionsle/v1/messagese thathamisa liphetho tseo model e li file, mme ho/v1/chat/completionsannotationse tšoaea moo karabo e bolelang e 'ngoe le e 'ngoe teng. Patlo ya webe
- Ntjha
web_search: trueho/v1/chat/completionsle/v1/messagese etsa web search pele model e araba mme e e fa liphetho e le mehloli e nomoroang. Kopo e fumaneng liphetho e sebelisa patlo e le 'ngoe ea allowance ea hau ea letsatsi le letsatsi. Ha ho e setseng, kopo e arajoa ntle le patlo. Patlo ya webe
- E lokisitswe
Stream e khaoloang ka lehlakoreng la server e lefisoa ka usage e tlalehiloeng ho fihlela sebakeng seo. Karolo e setseng ea reservation e khutlela ho balance ea hau.
- E lokisitswe
shannon-coder-1e araba ho/v1/responsesjoalo ka ha e etsa ho li-endpoint tse ling tse peli. Lisebelisoa tsa CLI tsa ho ngola code - E lokisitswe
Senotlolo sa API se fetotsoeng se emisa ho sebetsa hanghang.
- Ntjha
POST /v1/tokenizelePOST /v1/messages/count_tokens: palo ea mahala ea tokens bakeng sa li-model tse hosted tsa open-weight. Ho bala tokens - Ntjha
Prompt caching ho li-model tse hosted tsa open-weight. Input e cached e lefisoa ka 25% ea theko ea input mme e tlalehoa ho
usageho li-endpoint tse tharo tsohle:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokenslecache_read_input_tokens.GET /v1/modelse tlalehapricing.cached_input_per_million_usdlecapabilities.prompt_cachingbakeng sa li-model tsena. Caching ea Prompt - E lokisitswe
Li-model tse hosted tsa open-weight:
tool_choicee qobelloang (requiredkapa function e rehiloeng) e hlahisa kopo ea tool. Mekhosi ya mesebetsi - E lokisitswe
Li-model tse hosted tsa open-weight li amohela molaetsa oa
systemo seng molaetsa oa pele oa moqoqo.
- Ntjha
API e fumaneha e le Tor onion service le ho aterese ea I2P. Likarabo tsa
api.shannon-ai.comli nka liaterese tse peli ho li-header tsaOnion-LocationleX-I2P-Location. Li-endpoint tse ngotsoeng, Tor le I2P
- Ntjha
Li-model tse ncha
shannon-3.1leshannon-3.1-pro, tse thathamisitsoeng keGET /v1/models. Li-model le litheko - E fetotsoe
Kopo ea streaming eo client ea eona e itokollang e tsoela pele ho fihlela qetellong mme e baloa. Pele, karabo e ne e emisa ha ho itokolloa.
- E lokisitswe
Likopo ho
/v1/responsesli hlaha ho usage log.
- Ntjha
Li-model tse hosted tsa open-weight li sebelisa li-field tsa sampling:
temperature,top_p,seed,stoplemax_tokensho/v1/chat/completions;temperature,top_plestop_sequencesho/v1/messages;temperature,top_plemax_output_tokensho/v1/responses. Chat Completions - Ntjha
Usage log e bontša theko ka USD bakeng sa kopo e 'ngoe le e 'ngoe le e le kakaretso.
- E robehileng
Boleng ba
modelbo seng id e phatlalalitsoeng bo arajoa ka400, mofutainvalid_request_errorle molaetsaunknown model: <id>ho li-endpoint tse tharo tsohle. Pele, kopo e joalo e ne e arajoa keshannon-1.6-lite. Li-model le litheko - E robehileng
/v1e amohela senotlolo sa API feela. Cookie ea ho kena ea webosaete e ke ke ea baloa moo. Netefatso - E fetotsoe
Flood protection: likopo tse 120 ka motsotso ka akhaonte ho li-endpoint tse tharo tsa generation. Meeli le balance
- E ntlafaditswe
Ha model e sa khone ho araba, phoso e nka molaetsa o tsitsitseng
The model backend failed to answer. Please retry.Hlahlobo ea balance e sa khoneng ho etsoa e arajoa ka503le mofutaapi_error. Diphoso - E lokisitswe
Kopo e se nang streaming e hlolehang e khutlisetsa reservation ea eona ho balance ea hau.
- Ntjha
GET /v1/modelse tlalehacapabilities.reasoning_effortbakeng sa model e 'ngoe le e 'ngoe. Effort ea reasoning - E ntlafaditswe
Li-model tse hosted tsa open-weight: kopo e se nang streaming e sa fumaneng karabo e fela ka
504le mofutaapi_error. Sephetho se se nang letho ke502. Diphoso
- E robehileng
Li-model tse hosted tsa open-weight li amohela input eo model e rehiloeng e e amohelang. Setšoantšo se rometsoeng ho id ea mongolo feela se arajoa ka
400le<id> does not accept image input.response_formatho id e se nang structured output e arajoa ka400.GET /v1/modelse tlalehacapabilities.vision,response_formatlejson_schemabakeng sa id e 'ngoe le e 'ngoe. Litšoantšo le lifaele - E lokisitswe
Likarabo tse se nang streaming li nka mongolo oa reasoning:
reasoning_contentmolaetsa oa/v1/chat/completions, le block eathinkingpele ho mongolo ho/v1/messages. Effort ea reasoning - E fetotsoe
Li-model tse hosted tsa open-weight li na le litheko tse ncha, ho tloha ho $0.50 ka 1M input tokens le $2.00 ka 1M output tokens. Li-model le litheko
- E fetotsoe
Li-model tse hosted tsa open-weight li na le id e le 'ngoe ka model, li-id tse leshome le metso e 'meli ka kakaretso. Li-model le litheko
- Ntjha
Structured output ho
shannon-3,shannon-3-pro,shannon-3.1leshannon-3.1-pro.GET /v1/modelse tlalehacapabilities.json_schema: truebakeng sa tsona. Diphumo tse hlophisitsoeng - Ntjha
/v1/responsese balatext.format(json_objectkapajson_schema) bakeng sa structured output. Responses API - E lokisitswe
/v1/responsese khutlisa reasoning ea li-model tsa Shannon: ntho ea output eareasoningpele ho ntho eamessage, le li-event tsa streamresponse.reasoning_summary_text.deltaleresponse.reasoning_summary_text.done. Responses API - E lokisitswe
Field ea
modelea karabo ke id e phatlalalitsoeng ho endpoint e 'ngoe le e 'ngoe. Ntho ea Responses e nkamodellecreated_at. - E ntlafaditswe
GET /v1/modelse tlaleha context window ea model e 'ngoe le e 'ngoe. Li-model le litheko
- Ntjha
Li-model tse hosted tsa open-weight lia araba ho
/v1/messagesle/v1/responseshammoho le ho/v1/chat/completions, ka system prompt ea hau le likopo tsa tool./v1/messagese amohelathinking, mmereasoning_effortke field ea kopo. Li-model le litheko - E ntlafaditswe
Li-body tsa phoso ho
/v1li latela mebopeho ea SDK: ntho eaerrore nang letypelemessageho li-endpoint tsa sebopeho sa OpenAI, le ntho e tšoanang ka hare ho{"type": "error"}ho/v1/messages. Diphoso - Ntjha
Keep-alive ho li-stream tse bulehileng ka mor'a metsotsoana e 15 e 'ngoe le e 'ngoe: mohala oa maikutlo oa
: pingho/v1/chat/completions,event: pingho/v1/messages. Phallela - E fetotsoe
Li-id tsa likopo tsa tool li qala ka
call_ho/v1/chat/completionsle/v1/responses, le katoolu_ho/v1/messages. Mekhosi ya mesebetsi - E robehileng
/v1/responses:streamkefalseka default. Responses API - Ntjha
max_completion_tokense amohelwa e le lebitso le leng lamax_tokensho/v1/chat/completions. Chat Completions - E lokisitswe
Event ea
response.completedea stream ea Responses e nka array eaoutput. Responses API - Ntjha
Li-entry tsa
GET /v1/modelsli nkadisplay_name,context_window,max_output_tokens,pricing,capabilitiesleendpoints. Li-model le litheko - Ntjha
Karabo e 'ngoe le e 'ngoe e nka
x-request-id, mme boleng boo u bo romelang bo khutla. Li-body tsa likopo li ka ba 32 MiB. - Ntjha
Senotlolo se ka hlakoloa ntle le hore se secha se fanoe. Usage log e arotsoe ka maqephe.
- Ntjha
Litšoantšo le litokomane likopong: likarolo tsa
image_urlho/v1/chat/completions, li-block tsaimage,documentlefileho/v1/messages, likarolo tsainput_imageho/v1/responses. Litšoantšo le lifaele - Ntjha
Model e ncha
shannon-3-pro. Li-model le litheko
- Ntjha
Model e ncha
shannon-3. Li-model le litheko - Ntjha
Li-stream tsa
/v1/chat/completionsli nka reasoning e ledelta.reasoning_content. Effort ea reasoning
- E fetotsoe
max_tokense bolokoa pakeng tsa 1 le 65,536. Boleng bo kantle ho moeli oo bo isoa qetellong e haufi ka ho fetisisa, ha bo hanoe. Chat Completions
- Ntjha
shannon-coder-1e baloa ka likopo ka plan ho/v1/chat/completionsle/v1/messages. Ha likopo tsa fensetere li fela, karabo ke429e nang le molaetsaShannon Coder call quota reached. Lisebelisoa tsa CLI tsa ho ngola code - Ntjha
Moqoqo o moholo ho feta context window o arajoa ka
400, mofutainvalid_request_errorle codecontext_length_exceeded. Phoso ka hare ho stream e fihla e le event ea phoso, eseng e le mongolo karabong. Lisebelisoa tsa CLI tsa ho ngola code
- Ntjha
Li-endpoint tsa
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesleGET /v1/models. Ke li-endpoint tseo li-SDK tsa OpenAI le Anthropic, Claude Code le Codex CLI li li bitsang. Kakaretso - Ntjha
Likopo tsa tool ka
toolsho/v1/chat/completionsle/v1/messages, structured output karesponse_format, lesysteme le string kapa e le li-block tsa mongolo ho/v1/messages. Mekhosi ya mesebetsi
- Ntjha
Li-id tsa model
shannon-1.6-pro,shannon-2-lite,shannon-2-proleshannon-coder-1, haufi leshannon-1.6-lite. Li-model le litheko
- Ntjha
Phatlalatso ea pele ea API: chat ka sebopeho sa OpenAI le sebopeho sa Anthropic, le endpoint ea Responses, e 'ngoe le e 'ngoe e bitsoa ka senotlolo sa API se qalang ka
sk-. Netefatso