Rārangi panoni
Ngā whakahou me ngā whakapainga hou o te Shannon API.
Ka rārangi tēnei whārangi i ngā huringa ka kite koe hei kaikaranga o te API: ngā endpoint, āpure me model hōu, te whanonga kua huri me ngā whakatikatika. Ko ngā urunga hōu rawa te tuatahi. Kei ia urunga te rā i mahia ai te huringa.
Ka taea e tētahi urunga kua tohua Huringa pakaru te huri i te hua o tētahi tono i mahi i mua. Kotahi te putanga o te API, /v1, nō reira ka rārangitia ngā huringa mā te rā, kaua mā te tau putanga.
- Hou
Ka ingoatia e tētahi tono me te
web_search: trueōna pūtake: ka rārangitia e tesourcesi runga i te/v1/chat/completionsme te/v1/messagesngā hua i hoatu ki te model, ā, i runga i te/v1/chat/completionska tohu teannotationsi hea e whakahua ai te whakautu i ia tētahi. Rapu paetukutuku
- Hou
Ka whakahaere te
web_search: truei runga i te/v1/chat/completionsme te/v1/messagesi tētahi rapu tukutuku i mua i te whakautu a te model, ā, ka hoatu ngā hua ki a ia hei puna kua tau. Ka whakamahi tētahi tono i kitea ai ngā hua i tētahi rapu o tō whakaaetanga i ia rā. Ina kore he toe, ka whakautua te tono kāore he rapu. Rapu paetukutuku
- Whakatika
Ka utua tētahi stream ka tapahia i te taha server mō te usage i pūrongotia tae noa ki taua wā. Ka hoki te toenga o te rāhui ki tō toenga.
- Whakatika
Ka whakautu te
shannon-coder-1i runga i te/v1/responsespērā i tāna i runga i ērā atu endpoint e rua. Ngā taputapu CLI mō te tuhi code - Whakatika
Ka mutu tonu te mahi a tētahi API key kua hurihia.
- Hou
POST /v1/tokenizemePOST /v1/messages/count_tokens: ngā tatau token kore utu mō ngā model open-weight hosted. Te tatau token - Hou
Prompt caching i runga i ngā model open-weight hosted. Ka utua te input cached ki te 25% o te utu input, ā, ka pūrongotia i te
usagei runga i ngā endpoint e toru:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensmecache_read_input_tokens. Ka pūrongo teGET /v1/modelsi tepricing.cached_input_per_million_usdme tecapabilities.prompt_cachingmō ēnei model. Tūhono caching - Whakatika
Ngā model open-weight hosted: ka puta he tool call i tētahi
tool_choicekua tohea (requiredhe function kua ingoatia rānei). Karanga ā‑mahi - Whakatika
Ka whakaae ngā model open-weight hosted ki tētahi karere
systemehara i te karere tuatahi o te kōrero.
- Hou
Ka taea te tae atu ki te API hei Tor onion service, ā, i tētahi wāhitau I2P. Ka kawe ngā whakautu o
api.shannon-ai.comi ngā wāhitau e rua i ngā headerOnion-LocationmeX-I2P-Location. Ngā endpoint whakamuna, Tor & I2P
- Hou
Ngā model hōu
shannon-3.1meshannon-3.1-pro, kua rārangitia e teGET /v1/models. Ngā model me ngā utu - Kua huri
Ka rere tētahi tono stream ka motuhia tana kiritaki ki tōna mutunga, ā, ka tatauria. I mua, ka mutu te whakautu i te motunga.
- Whakatika
Ka puta ngā tono ki te
/v1/responsesi te usage log.
- Hou
Ka whakamahi ngā model open-weight hosted i ngā āpure sampling:
temperature,top_p,seed,stopmemax_tokensi runga i te/v1/chat/completions;temperature,top_pmestop_sequencesi runga i te/v1/messages;temperature,top_pmemax_output_tokensi runga i te/v1/responses. Chat Completions - Hou
Ka whakaatu te usage log i te utu USD mō ia karanga, me te tapeke.
- Huringa pakaru
Ka whakautua tētahi uara
modelehara i te id kua whakaputaina ki te400, te momoinvalid_request_errorme te karereunknown model: <id>i runga i ngā endpoint e toru. I mua, ka whakautua taua tono e teshannon-1.6-lite. Ngā model me ngā utu - Huringa pakaru
Ka tango te
/v1i tētahi API key anake. Kāore te cookie takiuru o te pae tukutuku e pānuitia ki reira. Whakamotuhēhē - Kua huri
Flood protection: 120 tono i ia meneti mō ia pūkete i runga i ngā endpoint whakaputa e toru. Ngā tepe me te toenga
- Whakapainga
Ina kore e taea e te model te whakautu, kei te hapa te karere pūmau
The model backend failed to answer. Please retry.Ka whakautua tētahi tirotiro toenga kāore e taea te mahi ki te503me te momoapi_error. Whakahaere hapa - Whakatika
Ka whakahoki tētahi tono kāore i stream ka rahua i tōna rāhui ki tō toenga.
- Hou
Ka pūrongo te
GET /v1/modelsi tecapabilities.reasoning_effortmō ia model. Reasoning effort - Whakapainga
Ngā model open-weight hosted: ka mutu tētahi tono kāore i stream kāore e whiwhi whakautu me te
504me te momoapi_error. Ko te hua kau he502. Whakahaere hapa
- Huringa pakaru
Ka tango ngā model open-weight hosted i te input e tangohia ana e te model kua ingoatia. Ka whakautua tētahi whakaahua i tukuna ki tētahi id kuputuhi-anake ki te
400me te<id> does not accept image input. Ka whakautua teresponse_formati runga i tētahi id kāore he output whakatakoto ki te400. Ka pūrongo teGET /v1/modelsi tecapabilities.vision,response_formatmejson_schemamō ia id. Ngā whakaahua me ngā kōnae - Whakatika
Ka kawe ngā whakautu kāore i stream i te kuputuhi reasoning:
reasoning_contenti runga i te karere o te/v1/chat/completions, me tētahi porakathinkingi mua i te kuputuhi i runga i te/v1/messages. Reasoning effort - Kua huri
He utu hōu ō ngā model open-weight hosted, mai i te $0.50 mō ia 1M input tokens me te $2.00 mō ia 1M output tokens. Ngā model me ngā utu
- Kua huri
Kotahi te id mō ia model open-weight hosted, tekau mā rua ngā id katoa. Ngā model me ngā utu
- Hou
Output whakatakoto i runga i te
shannon-3,shannon-3-pro,shannon-3.1meshannon-3.1-pro. Ka pūrongo teGET /v1/modelsi tecapabilities.json_schema: truemō rātou. Putanga hanganga - Hou
Ka pānui te
/v1/responsesi tetext.format(json_objecthejson_schemarānei) mō te output whakatakoto. Responses API - Whakatika
Ka whakahoki te
/v1/responsesi te reasoning o ngā model Shannon: he item outputreasoningi mua i te itemmessage, me ngā tuhinga streamresponse.reasoning_summary_text.deltameresponse.reasoning_summary_text.done. Responses API - Whakatika
Ko te āpure
modelo tētahi whakautu te id kua whakaputaina i ia endpoint. Ka kawe tētahi Responses object i temodelme tecreated_at. - Whakapainga
Ka pūrongo te
GET /v1/modelsi te matapihi horopaki o ia model. Ngā model me ngā utu
- Hou
Ka whakautu ngā model open-weight hosted i runga i te
/v1/messagesme te/v1/responsesi te taha o te/v1/chat/completions, me tō system prompt me ngā tool call. Ka tango te/v1/messagesi tethinking, ā, ko tereasoning_efforthe āpure tono. Ngā model me ngā utu - Whakapainga
Ka whai ngā tinana hapa i runga i te
/v1i ngā āhua SDK: heerrorobject me tetypeme temessagei runga i ngā endpoint hōputu OpenAI, ā, te object ōrite i roto i te{"type": "error"}i runga i te/v1/messages. Whakahaere hapa - Hou
Keep-alive i runga i ngā stream tuwhera ia 15 hekona: he rārangi kōrero
: pingi runga i te/v1/chat/completions, heevent: pingi runga i te/v1/messages. Rere - Kua huri
Ka tīmata ngā id tool call ki te
call_i runga i te/v1/chat/completionsme te/v1/responses, ā, ki tetoolu_i runga i te/v1/messages. Karanga ā‑mahi - Huringa pakaru
/v1/responses: ko te taunoa o testreamkofalse. Responses API - Hou
Ka whakaaetia te
max_completion_tokenshei ingoa kē mō temax_tokensi runga i te/v1/chat/completions. Chat Completions - Whakatika
Ka kawe te tuhinga
response.completedo tētahi stream Responses i te rārangioutput. Responses API - Hou
Ka kawe ngā urunga
GET /v1/modelsi tedisplay_name,context_window,max_output_tokens,pricing,capabilitiesmeendpoints. Ngā model me ngā utu - Hou
Ka kawe ia whakautu i te
x-request-id, ā, ka whakahokia te uara e tukuna ana e koe. Ka taea e ngā tinana tono te tae ki te 32 MiB. - Hou
Ka taea te whakakore i tētahi key me te kore e tukuna he key hōu. Ka wehea ki ngā whārangi te usage log.
- Hou
Ngā whakaahua me ngā tuhinga i ngā tono: ngā wāhanga
image_urli runga i te/v1/chat/completions, ngā porakaimage,documentmefilei runga i te/v1/messages, ngā wāhangainput_imagei runga i te/v1/responses. Ngā whakaahua me ngā kōnae - Hou
Model hōu
shannon-3-pro. Ngā model me ngā utu
- Hou
Model hōu
shannon-3. Ngā model me ngā utu - Hou
Ka kawe ngā stream i runga i te
/v1/chat/completionsi te reasoning heidelta.reasoning_content. Reasoning effort
- Kua huri
Ka puritia te
max_tokenski roto i te 1 ki te 65,536. Ka kawea tētahi uara i waho i taua whānui ki te pito tata rawa, kāore e whakakāhoretia. Chat Completions
- Hou
Ka tatauria te
shannon-coder-1i ngā karanga mō ia mahere i runga i te/v1/chat/completionsme te/v1/messages. Ina pau ngā karanga o tētahi matapihi, ko te whakautu he429me te karereShannon Coder call quota reached. Ngā taputapu CLI mō te tuhi code - Hou
Ka whakautua tētahi kōrero e nui ake ana i te matapihi horopaki ki te
400, te momoinvalid_request_errorme te waeherecontext_length_exceeded. Ka tae mai tētahi hapa i roto i tētahi stream hei tuhinga hapa, kaua hei kuputuhi i te whakautu. Ngā taputapu CLI mō te tuhi code
- Hou
Ngā endpoint
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesmeGET /v1/models. Koinei ngā endpoint e karangahia ana e ngā SDK OpenAI me Anthropic, Claude Code me Codex CLI. Tirohanga whānui - Hou
Ngā tool call me ngā
toolsi runga i te/v1/chat/completionsme te/v1/messages, te output whakatakoto me teresponse_format, me tesystemhei rārangi tuhi, hei poraka kuputuhi rānei i runga i te/v1/messages. Karanga ā‑mahi
- Hou
Ngā model id
shannon-1.6-pro,shannon-2-lite,shannon-2-promeshannon-coder-1, i te taha o teshannon-1.6-lite. Ngā model me ngā utu
- Hou
Te tukunga tuatahi o te API: te chat i te hōputu OpenAI me te hōputu Anthropic, me tētahi endpoint Responses, ia tētahi ka karangahia mā tētahi API key e tīmata ana ki te
sk-. Whakamotuhēhē