Rekodhi yeshanduko
Zvigadziriso zvichangoburwa uye kuvandudzwa kuShannon API.
Peji iyi inoratidza shanduko dzaunogona kuona semunhu anodanidzira API: ma-endpoint, ma-field nema-model matsva, hunhu hwakachinjwa nezvakagadziriswa. Zvitsva zviri pamberi. Entry imwe neimwe ine zuva rakaitwa shanduko.
Entry yakanzi Breaking inogona kuchinja mhedzisiro ye-request yaishanda kare. API ine vhezheni imwe, /v1, saka shanduko dzinoratidzwa nezuva, kwete nenhamba yevhezheni.
- Itsva
Request ine
web_search: trueinotaura sources dzayo:sourcespa-/v1/chat/completionsne-/v1/messagesinoronga mhedzisiro yakapiwa model, uye pa-/v1/chat/completionsannotationsinoratidza pane imwe neimwe yakataurwa mumhinduro. Kutsvaga pawebhu
- Itsva
web_search: truepa-/v1/chat/completionsne-/v1/messagesinomhanyisa web search model isati yapindura ndokuipa mhedzisiro se-numbered sources. Request yakawana mhedzisiro inoshandisa search imwe ye-daily allowance yako. Kana pasina yasara, request inopindurwa pasina search. Kutsvaga pawebhu
- Yakagadziriswa
Stream inodimburwa kuna server inobhadharwa nezvakashandiswa zvakaratidzwa kusvika panguva iyoyo. Zvasara ze-reservation zvinodzoka ku-balance yako.
- Yakagadziriswa
shannon-coder-1inopindura pa-/v1/responsessezvainoita pa-endpoints dzimwe mbiri. CLI tools dzekunyora code - Yakagadziriswa
API key yakachinjwa inomira kushanda pakarepo.
- Itsva
POST /v1/tokenizene-POST /v1/messages/count_tokens: kuverenga tokens kusingabhadharwi ye-hosted open-weight models. Kuverenga tokens - Itsva
Prompt caching pa-hosted open-weight models. Cached input inobhadharwa pa25% yemutengo we-input uye inoratidzwa mu-
usagepa-endpoints dzese nhatu:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensne-cache_read_input_tokens.GET /v1/modelsinoratidzapricing.cached_input_per_million_usdne-capabilities.prompt_cachingye-ma-model aya. Kuchenza kwe-prompt - Yakagadziriswa
Hosted open-weight models:
tool_choiceinomanikidzwa (requiredkana function yakatumidzwa) inogadzira tool call. Kudanwa kwemabasa - Yakagadziriswa
Hosted open-weight models dzinogamuchira
systemmessage isiri message yekutanga yehurukuro.
- Itsva
API inowanikwa se-Tor onion service uye pa-I2P address. Mhinduro dze-
api.shannon-ai.comdzinotakura ma-address maviri mu-Onion-Locationne-X-I2P-Locationheaders. Encrypted, Tor & I2P endpoints
- Itsva
Ma-model matsva
shannon-3.1ne-shannon-3.1-pro, anoratidzwa ne-GET /v1/models. Ma-model nemitengo - Yakachinjwa
Request ye-stream ine client inodisconnecta inomhanya kusvika kuguma kwayo uye inoverengwa. Kare, mhinduro yaimira pa-disconnect.
- Yakagadziriswa
Requests ku-
/v1/responsesdzinoonekwa mu-usage log.
- Itsva
Hosted open-weight models dzinoshandisa sampling fields:
temperature,top_p,seed,stopne-max_tokenspa-/v1/chat/completions;temperature,top_pne-stop_sequencespa-/v1/messages;temperature,top_pne-max_output_tokenspa-/v1/responses. Chat Completions - Itsva
Usage log inoratidza mutengo mu-USD we-call imwe neimwe uye se-total.
- Kuvhuna
modelvalue isiri published id inopindurwa ne-400, typeinvalid_request_errorne-messageunknown model: <id>pa-endpoints dzese nhatu. Kare, request yakadaro yaipindurwa ne-shannon-1.6-lite. Ma-model nemitengo - Kuvhuna
/v1inogamuchira API key chete. Sign-in cookie ye-website haiverengwi ipapo. Kusimbisa - Yakachinjwa
Flood protection: ma-request 120 paminiti imwe pa-account imwe pa-generation endpoints nhatu. Limits ne-balance
- Yakavandudzwa
Kana model isingagoni kupindura, error inotakura message yakatarwa
The model backend failed to answer. Please retry.Balance check isingaitiki inopindurwa ne-503ne-typeapi_error. Zvikanganiso - Yakagadziriswa
Request isiri streamed inokundikana inodzosera reservation yayo ku-balance yako.
- Itsva
GET /v1/modelsinoratidzacapabilities.reasoning_effortye-model imwe neimwe. Reasoning effort - Yakavandudzwa
Hosted open-weight models: request isiri streamed isingawani mhinduro inopera ne-
504ne-typeapi_error. Mhedzisiro isina chinhu i-502. Zvikanganiso
- Kuvhuna
Hosted open-weight models dzinogamuchira input inogamuchirwa ne-model yakatumidzwa. Mufananidzo wakatumirwa kune id ye-text chete unopindurwa ne-
400ne-<id> does not accept image input.response_formatpa-id isina structured output inopindurwa ne-400.GET /v1/modelsinoratidzacapabilities.vision,response_formatne-json_schemaye-id imwe neimwe. Mifananidzo ne-files - Yakagadziriswa
Mhinduro dzisiri streamed dzinotakura reasoning text:
reasoning_contentpa-message ye-/v1/chat/completions, ne-thinkingblock pamberi pe-text pa-/v1/messages. Reasoning effort - Yakachinjwa
Hosted open-weight models dzine mitengo mitsva, kubva pa-$0.50 pa1M input tokens ne-$2.00 pa1M output tokens. Ma-model nemitengo
- Yakachinjwa
Hosted open-weight models dzine id imwe pa-model imwe neimwe, ma-id gumi nemaviri pamwe chete. Ma-model nemitengo
- Itsva
Structured output pa-
shannon-3,shannon-3-pro,shannon-3.1ne-shannon-3.1-pro.GET /v1/modelsinoratidzacapabilities.json_schema: truekwadziri. Zvinobuda zvakarongeka - Itsva
/v1/responsesinoverengatext.format(json_objectkanajson_schema) ye-structured output. Responses API - Yakagadziriswa
/v1/responsesinodzosa reasoning ye-Shannon models:reasoningoutput item pamberi pe-messageitem, ne-stream eventsresponse.reasoning_summary_text.deltane-response.reasoning_summary_text.done. Responses API - Yakagadziriswa
modelfield yemhinduro ndiyo published id pa-endpoint imwe neimwe. Responses object inotakuramodelne-created_at. - Yakavandudzwa
GET /v1/modelsinoratidza context window ye-model imwe neimwe. Ma-model nemitengo
- Itsva
Hosted open-weight models dzinopindura pa-
/v1/messagesne-/v1/responsespamwe chete ne-/v1/chat/completions, dziine system prompt yako ne-tool calls./v1/messagesinogamuchirathinking, uyereasoning_efforti-request field. Ma-model nemitengo - Yakavandudzwa
Error bodies pa-
/v1dzinotevera zvimiro zve-SDK:errorobject inetypene-messagepa-endpoints dze-OpenAI-format, uye object imwechete mukati me-{"type": "error"}pa-/v1/messages. Zvikanganiso - Itsva
Keep-alive pa-streams dzakavhurika masekonzi 15 ega ega: mutsara we-comment
: pingpa-/v1/chat/completions,event: pingpa-/v1/messages. Kuyerera - Yakachinjwa
Tool call ids dzinotanga ne-
call_pa-/v1/chat/completionsne-/v1/responses, uye ne-toolu_pa-/v1/messages. Kudanwa kwemabasa - Kuvhuna
/v1/responses:streamdefault i-false. Responses API - Itsva
max_completion_tokensinogamuchirwa sezita rakasiyana re-max_tokenspa-/v1/chat/completions. Chat Completions - Yakagadziriswa
response.completedevent ye-Responses stream inotakuraoutputarray. Responses API - Itsva
Entries dze-
GET /v1/modelsdzinotakuradisplay_name,context_window,max_output_tokens,pricing,capabilitiesne-endpoints. Ma-model nemitengo - Itsva
Mhinduro imwe neimwe inotakura
x-request-id, uye value yaunotumira inodzoserwa. Request bodies dzinogona kusvika ku-32 MiB. - Itsva
Key inogona kubviswa pasina kupiwa itsva. Usage log yakaparadzaniswa kuita mapeji.
- Itsva
Mifananidzo ne-documents mu-requests:
image_urlparts pa-/v1/chat/completions,image,documentne-fileblocks pa-/v1/messages,input_imageparts pa-/v1/responses. Mifananidzo ne-files - Itsva
Model itsva
shannon-3-pro. Ma-model nemitengo
- Itsva
Model itsva
shannon-3. Ma-model nemitengo - Itsva
Streams pa-
/v1/chat/completionsdzinotakura reasoning se-delta.reasoning_content. Reasoning effort
- Yakachinjwa
max_tokensinochengetwa pakati pe-1 ne-65,536. Value iri kunze kwe-range iyoyo inoiswa pamucheto wakapoteredza, hairamburwi. Chat Completions
- Itsva
shannon-coder-1inoverengwa mu-calls pa-plan pa-/v1/chat/completionsne-/v1/messages. Kana calls dzewindow dzapera, mhinduro i-429ine messageShannon Coder call quota reached. CLI tools dzekunyora code - Itsva
Hurukuro hurefu kupfuura context window inopindurwa ne-
400, typeinvalid_request_errorne-codecontext_length_exceeded. Error iri mukati me-stream inouya se-error event, kwete se-text mumhinduro. CLI tools dzekunyora code
- Itsva
/v1endpoints:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesne-GET /v1/models. Ndidzo endpoints dzinodanidzirwa ne-OpenAI ne-Anthropic SDKs, Claude Code ne-Codex CLI. Pfupiso - Itsva
Tool calls ne-
toolspa-/v1/chat/completionsne-/v1/messages, structured output ne-response_format, ne-systemse-string kana se-text blocks pa-/v1/messages. Kudanwa kwemabasa
- Itsva
Model ids
shannon-1.6-pro,shannon-2-lite,shannon-2-prone-shannon-coder-1, padivi pe-shannon-1.6-lite. Ma-model nemitengo
- Itsva
Kuburitswa kwekutanga kwe-API: chat mu-OpenAI format nemu-Anthropic format, ne-Responses endpoint, imwe neimwe inodanidzirwa ne-API key inotanga ne-
sk-. Kusimbisa