වෙනස්කම් ලේඛනය
Shannon API සඳහා නවතම යාවත්කාලීන සහ වැඩිදියුණු කිරීම්.
මෙම පිටුවේ API එකේ කැඳවුම්කරුවෙකු (caller) ලෙස ඔබට නිරීක්ෂණය කළ හැකි වෙනස්කම් ලැයිස්තුගත කර ඇත: නව endpoints, fields සහ models, වෙනස් වූ හැසිරීම සහ නිවැරදි කිරීම්. අලුත්ම ප්රවේශ පළමුව පිළියෙල කර ඇත. සෑම ප්රවේශයකම වෙනස සිදු කළ දිනය ඇත.
Breaking ලෙස සලකුණු කළ ප්රවේශයක් මීට පෙර ක්රියා කළ ඉල්ලීමක ප්රතිඵලය වෙනස් කළ හැක. API එකට එක අනුවාදයක් පමණක් ඇත, /v1, එබැවින් වෙනස්කම් ලැයිස්තුගත කර ඇත්තේ අනුවාද අංකයෙන් නොව දිනයෙනි.
- නව
web_search: trueසහිත ඉල්ලීමක් එහි මූලාශ්රවල නම් දක්වයි:/v1/chat/completionsසහ/v1/messagesහිsourcesමඟින් model එකට දුන් ප්රතිඵල ලැයිස්තුගත කරයි,/v1/chat/completionsහිannotationsමඟින් පිළිතුර ඒ සෑම එකක්ම උපුටා දක්වන තැන සලකුණු කරයි. වෙබ් සෙවීම
- නව
/v1/chat/completionsසහ/v1/messagesහිweb_search: truemodel එක පිළිතුරු දීමට පෙර web search එකක් ක්රියාත්මක කර ප්රතිඵල අංක ගත මූලාශ්ර ලෙස එයට ලබා දෙයි. ප්රතිඵල සොයාගත් ඉල්ලීමක් ඔබේ දෛනික ප්රමාණයෙන් එක සෙවීමක් භාවිතා කරයි. කිසිවක් ඉතිරි නැති විට, ඉල්ලීමට සෙවීමක් නොමැතිව පිළිතුරු ලැබේ. වෙබ් සෙවීම
- සකස් කළ
Server පැත්තෙන් කපා හරින stream එකකට, එතෙක් වාර්තා වූ usage සඳහා බිල් කෙරේ. වෙන්කිරීමේ ඉතිරිය ඔබේ ශේෂයට ආපසු එයි.
- සකස් කළ
shannon-coder-1අනෙක් endpoints දෙකේ මෙන්ම/v1/responsesහි ද පිළිතුරු දෙයි. CLI coding මෙවලම් - සකස් කළ
මාරු කළ API key එකක් වහාම ක්රියා කිරීම නවතී.
- නව
POST /v1/tokenizeසහPOST /v1/messages/count_tokens: අපගේ සේවාදායකවල ධාවනය වන open-weight models සඳහා නොමිලේ token ගණන්. Token ගණන් කිරීම - නව
අපගේ සේවාදායකවල ධාවනය වන open-weight models මත Prompt caching. Cached input input මිලෙන් 25%කට බිල් කෙරෙන අතර endpoints තුනේම
usageහි වාර්තා කෙරේ:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensසහcache_read_input_tokens.GET /v1/modelsමෙම models සඳහාpricing.cached_input_per_million_usdසහcapabilities.prompt_cachingවාර්තා කරයි. Prompt caching - සකස් කළ
අපගේ සේවාදායකවල ධාවනය වන open-weight models: බලකළ
tool_choice(requiredහෝ නම් කළ function එකක්) tool call එකක් ලබා දෙයි. කාර්ය කැඳවීම - සකස් කළ
අපගේ සේවාදායකවල ධාවනය වන open-weight models සංවාදයේ පළමු පණිවිඩය නොවන
systemපණිවිඩයක් පිළිගනී.
- නව
API එකට Tor onion service එකක් ලෙස සහ I2P ලිපිනයකින් ළඟා විය හැක.
api.shannon-ai.comහි පිළිතුරුOnion-LocationසහX-I2P-Locationheaders වල එම ලිපින දෙක රැගෙන යයි. සංකේතනය කළ, Tor සහ I2P endpoints
- නව
නව models
shannon-3.1සහshannon-3.1-pro,GET /v1/modelsමගින් ලැයිස්තුගත කෙරේ. Models සහ මිල ගණන් - වෙනස් කළ
Client එක විසන්ධි වන stream කළ ඉල්ලීමක් අවසානය දක්වා ධාවනය වී ගණන් ගැනේ. මීට පෙර පිළිතුර විසන්ධි වූ තැනින් නතර විය.
- සකස් කළ
/v1/responsesවෙත ඉල්ලීම් usage log එකේ දිස්වේ.
- නව
අපගේ සේවාදායකවල ධාවනය වන open-weight models sampling fields ක්රියාත්මක කරයි:
/v1/chat/completionsහිtemperature,top_p,seed,stopසහmax_tokens;/v1/messagesහිtemperature,top_pසහstop_sequences;/v1/responsesහිtemperature,top_pසහmax_output_tokens. Chat Completions - නව
Usage log එක සෑම call එකකටම සහ මුළු එකතුවක් ලෙසද USD වලින් පිරිවැයක් පෙන්වයි.
- බිඳෙන
ප්රකාශිත id එකක් නොවන
modelඅගයකට endpoints තුනේම400,invalid_request_errortype එක සහunknown model: <id>පණිවිඩය සමඟ පිළිතුරු ලැබේ. මීට පෙර එවැනි ඉල්ලීමකටshannon-1.6-liteපිළිතුරු දුන්නේය. Models සහ මිල ගණන් - බිඳෙන
/v1API key එකක් පමණක් ගනී. වෙබ් අඩවියේ sign-in cookie එකක් එහි කියවන්නේ නැත. සත්යාපනය - වෙනස් කළ
Flood protection: ජනන endpoints තුනේ ගිණුමකට විනාඩියකට ඉල්ලීම් 120. සීමා සහ ශේෂය
- වැඩි දියුණු
Model එකට පිළිතුරු දිය නොහැකි විට, දෝෂයේ
The model backend failed to answer. Please retry.යන ස්ථාවර පණිවිඩය ඇත. කළ නොහැකි ශේෂ පරීක්ෂාවකට503සහapi_errortype එක සමඟ පිළිතුරු ලැබේ. දෝෂ - සකස් කළ
අසාර්ථක වන stream නොකළ ඉල්ලීමක් තම වෙන්කිරීම (reservation) ඔබේ ශේෂයට ආපසු දෙයි.
- නව
GET /v1/modelsසෑම model එකකටමcapabilities.reasoning_effortවාර්තා කරයි. Reasoning effort - වැඩි දියුණු
අපගේ සේවාදායකවල ධාවනය වන open-weight models: පිළිතුරක් නොලැබෙන stream නොකළ ඉල්ලීමක්
504සහapi_errortype එක සමඟ අවසන් වේ. හිස් ප්රතිඵලයක්502වේ. දෝෂ
- බිඳෙන
අපගේ සේවාදායකවල ධාවනය වන open-weight models නම් කළ model එක පිළිගන්නා input පිළිගනී. පෙළ පමණක් ඇති id එකකට යවන රූපයකට
400සහ<id> does not accept image inputසමඟ පිළිතුරු ලැබේ. ව්යුහගත output නැති id එකකresponse_formatඑකට400සමඟ පිළිතුරු ලැබේ.GET /v1/modelsසෑම id එකකටමcapabilities.vision,response_formatසහjson_schemaවාර්තා කරයි. රූප සහ ගොනු - සකස් කළ
Stream නොකළ පිළිතුරු තර්කන පෙළ රැගෙන යයි:
/v1/chat/completionsහි පණිවිඩයේreasoning_content, සහ/v1/messagesහි පෙළට පෙරthinkingblock එකක්. Reasoning effort - වෙනස් කළ
අපගේ සේවාදායකවල ධාවනය වන open-weight models සඳහා අලුත් මිල ගණන් ඇත, input tokens 1M කට $0.50 සිට සහ output tokens 1M කට $2.00 සිට. Models සහ මිල ගණන්
- වෙනස් කළ
අපගේ සේවාදායකවල ධාවනය වන open-weight models සඳහා model එකකට එක id බැගින් ඇත, සියල්ලම id දොළහක්. Models සහ මිල ගණන්
- නව
shannon-3,shannon-3-pro,shannon-3.1සහshannon-3.1-proහි ව්යුහගත output.GET /v1/modelsඒවා සඳහාcapabilities.json_schema: trueවාර්තා කරයි. ව්යුහගත ප්රතිදාන - නව
/v1/responsesව්යුහගත output සඳහාtext.format(json_objectහෝjson_schema) කියවයි. Responses API - සකස් කළ
/v1/responsesShannon models වල තර්කනය ආපසු දෙයි:messageitem එකට පෙරreasoningoutput item එකක්, සහ stream eventsresponse.reasoning_summary_text.deltaසහresponse.reasoning_summary_text.done. Responses API - සකස් කළ
පිළිතුරක
modelfield එක සෑම endpoint එකකම ප්රකාශිත id එක වේ. Responses object එකක්modelසහcreated_atරැගෙන යයි. - වැඩි දියුණු
GET /v1/modelsසෑම model එකකම context window එක වාර්තා කරයි. Models සහ මිල ගණන්
- නව
අපගේ සේවාදායකවල ධාවනය වන open-weight models
/v1/chat/completionsහි මෙන්ම/v1/messagesසහ/v1/responsesහි ද, ඔබේ system prompt සහ tool calls සමඟ පිළිතුරු දෙයි./v1/messagesthinkingගනී, සහreasoning_effortඉල්ලීමේ field එකකි. Models සහ මිල ගණන් - වැඩි දියුණු
/v1හි දෝෂ body SDK හැඩතල අනුගමනය කරයි: OpenAI-format endpoints හිtypeසහmessageසහිතerrorobject එකක්, සහ/v1/messagesහි{"type": "error"}තුළ එම object එකම. දෝෂ - නව
විවෘත streams මත තත්පර 15කට වරක් Keep-alive:
/v1/chat/completionsහි: pingcomment පේළියක්,/v1/messagesහිevent: pingඑකක්. ස්ට්රීමිං - වෙනස් කළ
Tool call ids
/v1/chat/completionsසහ/v1/responsesහිcall_වලින් ද,/v1/messagesහිtoolu_වලින් ද ආරම්භ වේ. කාර්ය කැඳවීම - බිඳෙන
/v1/responses:streamපෙරනිමියෙන්falseවේ. Responses API - නව
/v1/chat/completionsහිmax_completion_tokensmax_tokensසඳහා වෙනත් නමක් ලෙස පිළිගනී. Chat Completions - සකස් කළ
Responses stream එකක
response.completedevent එකoutputarray එක රැගෙන යයි. Responses API - නව
GET /v1/modelsentriesdisplay_name,context_window,max_output_tokens,pricing,capabilitiesසහendpointsරැගෙන යයි. Models සහ මිල ගණන් - නව
සෑම පිළිතුරක්ම
x-request-idරැගෙන යන අතර, ඔබ යවන අගයක් ආපසු ලැබේ. ඉල්ලීම් body 32 MiB දක්වා විය හැක. - නව
අලුත් key එකක් නිකුත් නොකර key එකක් අවලංගු කළ හැක. Usage log එක පිටු වශයෙන් බෙදා ඇත.
- නව
ඉල්ලීම්වල රූප සහ ලේඛන:
/v1/chat/completionsහිimage_urlකොටස්,/v1/messagesහිimage,documentසහfileblocks,/v1/responsesහිinput_imageකොටස්. රූප සහ ගොනු - නව
නව model
shannon-3-pro. Models සහ මිල ගණන්
- නව
නව model
shannon-3. Models සහ මිල ගණන් - නව
/v1/chat/completionsහි streams තර්කනයdelta.reasoning_contentලෙස රැගෙන යයි. Reasoning effort
- වෙනස් කළ
max_tokens1 සිට 65,536 දක්වා තුළ තබා ගනී. එම පරාසයෙන් පිටත අගයක් ප්රතික්ෂේප නොකර ළඟම කෙළවරට ගෙන එනු ලැබේ. Chat Completions
- නව
shannon-coder-1/v1/chat/completionsසහ/v1/messagesහි සැලසුමකට calls ගණනින් ගණන් කෙරේ. කවුළුවක calls අවසන් වූ විට, පිළිතුරShannon Coder call quota reachedපණිවිඩය සහිත429වේ. CLI coding මෙවලම් - නව
Context window එකට වඩා විශාල සංවාදයකට
400,invalid_request_errortype එක සහcontext_length_exceededcode එක සමඟ පිළිතුරු ලැබේ. Stream එකක් තුළ දෝෂයක් පැමිණෙන්නේ පිළිතුරේ පෙළක් ලෙස නොව error event එකක් ලෙසය. CLI coding මෙවලම්
- නව
/v1endpoints සතරක්:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesසහGET /v1/models. OpenAI SDKs, Anthropic SDKs, Claude Code සහ Codex CLI යන මෙවලම් call කරන endpoints මේවාය. සාරාංශය - නව
/v1/chat/completionsසහ/v1/messagesහිtoolsසමඟ tool calls,response_formatසමඟ ව්යුහගත output, සහ/v1/messagesහි string එකක් ලෙස හෝ text blocks ලෙසsystem. කාර්ය කැඳවීම
- නව
shannon-1.6-liteට අමතරවshannon-1.6-pro,shannon-2-lite,shannon-2-proසහshannon-coder-1යන model ids. Models සහ මිල ගණන්
- නව
API එකේ පළමු නිකුතුව: OpenAI format එකෙන් සහ Anthropic format එකෙන් chat, සහ Responses endpoint එකක්, ඒ සෑම එකක්ම
sk-වලින් ආරම්භ වන API key එකකින් call කෙරේ. සත්යාපනය