ပြောင်းလဲမှု မှတ်တမ်း
Shannon API ၏ နောက်ဆုံး ပြင်ဆင်မှုများနှင့် တိုးတက်မှုများ။
ဤစာမျက်နှာတွင် API ကို ခေါ်သူအနေဖြင့် သတိပြုမိနိုင်သော ပြောင်းလဲမှုများကို စာရင်းပြုစုထားသည်- endpoint၊ field နှင့် မော်ဒယ်အသစ်များ၊ အပြုအမူ ပြောင်းလဲမှုများနှင့် ပြုပြင်မှုများ။ အသစ်ဆုံး entry များကို ရှေ့ဆုံးတွင် ထားသည်။ Entry တစ်ခုစီတွင် ပြောင်းလဲသည့်ရက်စွဲ ပါဝင်သည်။
Breaking ဟု အမှတ်အသားပြုထားသော entry သည် ယခင်က အလုပ်လုပ်ခဲ့သည့် request ၏ ရလဒ်ကို ပြောင်းလဲစေနိုင်သည်။ API တွင် ဗားရှင်းတစ်ခုတည်း (/v1) ရှိသဖြင့် ပြောင်းလဲမှုများကို ဗားရှင်းနံပါတ်ဖြင့် မဟုတ်ဘဲ ရက်စွဲဖြင့် စာရင်းပြုစုထားသည်။
- အသစ်
web_search: trueပါသော request သည် ၎င်း၏ source များကို အမည်ဖြင့်ဖော်ပြသည်-/v1/chat/completionsနှင့်/v1/messagesပေါ်ရှိsourcesက model ကို ပေးခဲ့သော ရလဒ်များကို စာရင်းပြုစုပြီး/v1/chat/completionsပေါ်ရှိannotationsက အဖြေက တစ်ခုစီကို ကိုးကားသည့်နေရာကို အမှတ်အသားပြုသည်။ ဝဘ်ရှာဖွေမှု
- အသစ်
/v1/chat/completionsနှင့်/v1/messagesတွင်web_search: trueသည် မော်ဒယ်မဖြေမီ web search ကို run ပြီး ရလဒ်များကို နံပါတ်တပ်ထားသော source များအဖြစ် ပေးသည်။ ရလဒ်ရှာတွေ့သော request သည် သင့်နေ့စဉ် allowance မှ search တစ်ကြိမ်ကို သုံးသည်။ မကျန်တော့လျှင် request ကို search မပါဘဲ ဖြေကြားသည်။ ဝဘ်ရှာဖွေမှု
- ပြင်ဆင်
Server ဘက်တွင် ဖြတ်တောက်ခံရသော stream ကို ထိုအချိန်အထိ ဖော်ပြခဲ့သော usage အတွက် ကောက်ခံသည်။ ကြိုတင်ထားရှိမှု၏ ကျန်အပိုင်းကို သင့်လက်ကျန်သို့ ပြန်ပေးသည်။
- ပြင်ဆင်
shannon-coder-1သည် အခြား endpoint နှစ်ခုတွင်ကဲ့သို့/v1/responsesတွင်လည်း ဖြေကြားသည်။ CLI coding tools - ပြင်ဆင်
လဲလှယ်လိုက်သော API key သည် ချက်ချင်း အလုပ်မလုပ်တော့ပါ။
- အသစ်
POST /v1/tokenizeနှင့်POST /v1/messages/count_tokens- host လုပ်ထားသော open-weight မော်ဒယ်များအတွက် အခမဲ့ token ရေတွက်ခြင်း။ Token ရေတွက်ခြင်း - အသစ်
Host လုပ်ထားသော open-weight မော်ဒယ်များတွင် prompt caching။ Cache လုပ်ထားသော input ကို input ဈေး၏ 25% ဖြင့် ကောက်ခံပြီး endpoint သုံးခုလုံးရှိ
usageတွင် ဖော်ပြသည်-prompt_tokens_details.cached_tokens၊input_tokens_details.cached_tokensနှင့်cache_read_input_tokens။GET /v1/modelsသည် ဤမော်ဒယ်များအတွက်pricing.cached_input_per_million_usdနှင့်capabilities.prompt_cachingကို ဖော်ပြသည်။ Prompt caching - ပြင်ဆင်
Host လုပ်ထားသော open-weight မော်ဒယ်များ- အတင်းအကျပ်ခေါ်စေသော
tool_choice(requiredသို့မဟုတ် အမည်ပေးထားသော function) သည် tool call တစ်ခုကို ထုတ်ပေးသည်။ လုပ်ဆောင်ချက် ခေါ်ဆိုမှု - ပြင်ဆင်
Host လုပ်ထားသော open-weight မော်ဒယ်များသည် စကားပြောဆိုမှု၏ ပထမ message မဟုတ်သော
systemmessage ကို လက်ခံသည်။
- အသစ်
API ကို Tor onion service အဖြစ်နှင့် I2P လိပ်စာတွင် ချိတ်ဆက်နိုင်သည်။
api.shannon-ai.com၏ reply များတွင် လိပ်စာနှစ်ခုကိုOnion-Locationနှင့်X-I2P-Locationheader များဖြင့် ပေးသည်။ Encrypted, Tor နှင့် I2P endpoints
- အသစ်
GET /v1/modelsက စာရင်းပြသော မော်ဒယ်အသစ်များshannon-3.1နှင့်shannon-3.1-pro။ Model များနှင့် ဈေးနှုန်း - ပြောင်းလဲသည်
Client ချိတ်ဆက်မှု ပြတ်သွားသော streamed request သည် အဆုံးထိ run ပြီး ရေတွက်ခံရသည်။ ယခင်က ချိတ်ဆက်မှုပြတ်သည့်နေရာတွင် အဖြေ ရပ်သွားသည်။
- ပြင်ဆင်
/v1/responsesသို့ ပို့သော request များသည် usage log တွင် ပေါ်လာသည်။
- အသစ်
Host လုပ်ထားသော open-weight မော်ဒယ်များသည် sampling field များကို အသုံးပြုသည်-
/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 ဖြင့် ကုန်ကျစရိတ်ကို ပြသည်။
- Breaking
ထုတ်ပြန်ထားသော id မဟုတ်သည့်
modelတန်ဖိုးကို endpoint သုံးခုလုံးတွင်400၊ typeinvalid_request_errorနှင့် messageunknown model: <id>ဖြင့် ဖြေကြားသည်။ ယခင်က ထိုကဲ့သို့ request ကိုshannon-1.6-liteက ဖြေကြားခဲ့သည်။ Model များနှင့် ဈေးနှုန်း - Breaking
/v1သည် API key ကိုသာ လက်ခံသည်။ ဝက်ဘ်ဆိုက်၏ sign-in cookie ကို ထိုနေရာတွင် မဖတ်ပါ။ အတည်ပြုမှု - ပြောင်းလဲသည်
Flood protection- generation endpoint သုံးခုတွင် အကောင့်တစ်ခုလျှင် တစ်မိနစ်လျှင် request 120 ။ ကန့်သတ်ချက်များနှင့် လက်ကျန်ငွေ
- တိုးတက်
မော်ဒယ်က မဖြေနိုင်သည့်အခါ error တွင်
The model backend failed to answer. Please retry.ဟူသော သတ်မှတ်ထားသည့် message ပါဝင်သည်။ မလုပ်ဆောင်နိုင်သော လက်ကျန်စစ်ဆေးမှုကို503နှင့် typeapi_errorဖြင့် ဖြေကြားသည်။ အမှားကိုင်တွယ်မှု - ပြင်ဆင်
မအောင်မြင်သော non-streamed request သည် ၎င်း၏ ကြိုတင်ထားရှိမှု (reservation) ကို သင့်လက်ကျန်သို့ ပြန်ပေးသည်။
- အသစ်
GET /v1/modelsသည် မော်ဒယ်တစ်ခုစီအတွက်capabilities.reasoning_effortကို ဖော်ပြသည်။ Reasoning effort - တိုးတက်
Host လုပ်ထားသော open-weight မော်ဒယ်များ- အဖြေမရသော non-streamed request သည်
504နှင့် typeapi_errorဖြင့် ပြီးဆုံးသည်။ ရလဒ်ဗလာသည်502ဖြစ်သည်။ အမှားကိုင်တွယ်မှု
- Breaking
Host လုပ်ထားသော open-weight မော်ဒယ်များသည် အမည်ပေးထားသော မော်ဒယ်လက်ခံသည့် input ကို လက်ခံသည်။ စာသားသီးသန့် id သို့ ပို့သော ပုံကို
400နှင့်<id> does not accept image inputဖြင့် ဖြေကြားသည်။ Structured output မရှိသော id တွင်response_formatကို400ဖြင့် ဖြေကြားသည်။GET /v1/modelsသည် id တစ်ခုစီအတွက်capabilities.vision၊response_formatနှင့်json_schemaကို ဖော်ပြသည်။ ပုံများနှင့် ဖိုင်များ - ပြင်ဆင်
Stream မလုပ်သော reply များတွင် reasoning စာသား ပါဝင်သည်-
/v1/chat/completions၏ message တွင်reasoning_contentနှင့်/v1/messagesတွင် စာသားမတိုင်မီthinkingblock။ Reasoning effort - ပြောင်းလဲသည်
Host လုပ်ထားသော open-weight မော်ဒယ်များ၏ ဈေးနှုန်းအသစ်များ၊ input token 1M လျှင် $0.50 နှင့် output token 1M လျှင် $2.00 မှ စတင်သည်။ Model များနှင့် ဈေးနှုန်း
- ပြောင်းလဲသည်
Host လုပ်ထားသော open-weight မော်ဒယ်များတွင် မော်ဒယ်တစ်ခုလျှင် id တစ်ခုစီ ရှိပြီး စုစုပေါင်း id ဆယ့်နှစ်ခု ဖြစ်သည်။ Model များနှင့် ဈေးနှုန်း
- အသစ်
shannon-3၊shannon-3-pro၊shannon-3.1နှင့်shannon-3.1-proတွင် structured output။GET /v1/modelsသည် ၎င်းတို့အတွက်capabilities.json_schema: trueကို ဖော်ပြသည်။ ဖွဲ့စည်းထားသော အထွက် - အသစ်
/v1/responsesသည် structured output အတွက်text.format(json_objectသို့မဟုတ်json_schema) ကို ဖတ်သည်။ Responses API - ပြင်ဆင်
/v1/responsesသည် Shannon မော်ဒယ်များ၏ reasoning ကို ပြန်ပေးသည်-messageitem မတိုင်မီreasoningoutput item နှင့် stream event များresponse.reasoning_summary_text.deltaနှင့်response.reasoning_summary_text.done။ Responses API - ပြင်ဆင်
Reply ၏
modelfield သည် endpoint တိုင်းတွင် ထုတ်ပြန်ထားသော id ဖြစ်သည်။ Responses object တွင်modelနှင့်created_atပါဝင်သည်။ - တိုးတက်
GET /v1/modelsသည် မော်ဒယ်တစ်ခုစီ၏ context window ကို ဖော်ပြသည်။ Model များနှင့် ဈေးနှုန်း
- အသစ်
Host လုပ်ထားသော open-weight မော်ဒယ်များသည်
/v1/chat/completionsသာမက/v1/messagesနှင့်/v1/responsesတွင်လည်း သင့် system prompt နှင့် tool call များဖြင့် ဖြေကြားသည်။/v1/messagesကthinkingကို လက်ခံပြီးreasoning_effortသည် request field ဖြစ်သည်။ Model များနှင့် ဈေးနှုန်း - တိုးတက်
/v1ပေါ်ရှိ error body များသည် SDK ပုံစံများကို လိုက်နာသည်- OpenAI-format endpoint များတွင်typeနှင့်messageပါသောerrorobject၊/v1/messagesတွင်{"type": "error"}အတွင်း တူညီသော object။ အမှားကိုင်တွယ်မှု - အသစ်
ဖွင့်ထားသော stream များတွင် 15 စက္ကန့်တိုင်း keep-alive-
/v1/chat/completionsတွင်: pingcomment လိုင်း၊/v1/messagesတွင်event: ping။ စตรีမင်း - ပြောင်းလဲသည်
Tool call id များသည်
/v1/chat/completionsနှင့်/v1/responsesတွင်call_ဖြင့်လည်း၊/v1/messagesတွင်toolu_ဖြင့်လည်း စသည်။ လုပ်ဆောင်ချက် ခေါ်ဆိုမှု - Breaking
/v1/responses-stream၏ default သည်falseဖြစ်သည်။ Responses API - အသစ်
/v1/chat/completionsတွင်max_completion_tokensကိုmax_tokens၏ အခြားအမည်အဖြစ် လက်ခံသည်။ Chat Completions - ပြင်ဆင်
Responses စီးကြောင်း၏
response.completedevent တွင်outputarray ပါဝင်သည်။ Responses API - အသစ်
GET /v1/modelsentry များတွင်display_name၊context_window၊max_output_tokens၊pricing၊capabilitiesနှင့်endpointsပါဝင်သည်။ Model များနှင့် ဈေးနှုန်း - အသစ်
Reply တိုင်းတွင်
x-request-idပါဝင်ပြီး သင်ပို့သော တန်ဖိုးကို ပြန်ပေးသည်။ Request body များသည် 32 MiB အထိ ရှိနိုင်သည်။ - အသစ်
Key အသစ်မထုတ်ဘဲ key တစ်ခုကို ပယ်ဖျက်နိုင်သည်။ Usage log ကို စာမျက်နှာခွဲထားသည်။
- အသစ်
Request များတွင် ပုံများနှင့် စာရွက်စာတမ်းများ-
/v1/chat/completionsတွင်image_urlအပိုင်းများ၊/v1/messagesတွင်image၊documentနှင့်fileblock များ၊/v1/responsesတွင်input_imageအပိုင်းများ။ ပုံများနှင့် ဖိုင်များ - အသစ်
မော်ဒယ်အသစ်
shannon-3-pro။ Model များနှင့် ဈေးနှုန်း
- အသစ်
မော်ဒယ်အသစ်
shannon-3။ Model များနှင့် ဈေးနှုန်း - အသစ်
/v1/chat/completionsပေါ်ရှိ stream များသည် reasoning ကိုdelta.reasoning_contentအဖြစ် သယ်ဆောင်သည်။ Reasoning effort
- ပြောင်းလဲသည်
max_tokensကို 1 မှ 65,536 အတွင်း ထိန်းထားသည်။ ထိုအတိုင်းအတာအပြင်ဘက်ရှိ တန်ဖိုးကို ငြင်းပယ်မည့်အစား အနီးဆုံးအစွန်းသို့ ရွှေ့ပေးသည်။ Chat Completions
- အသစ်
/v1/chat/completionsနှင့်/v1/messagesတွင်shannon-coder-1ကို plan အလိုက် call အရေအတွက်ဖြင့် ရေတွက်သည်။ Window တစ်ခု၏ call များ ကုန်သွားသောအခါ reply သည်Shannon Coder call quota reachedဟူသော message ပါသည့်429ဖြစ်သည်။ CLI coding tools - အသစ်
Context window ထက်ကြီးသော စကားပြောဆိုမှုကို
400၊ typeinvalid_request_errorနှင့် codecontext_length_exceededဖြင့် ဖြေကြားသည်။ Stream အတွင်းရှိ error သည် အဖြေထဲရှိ စာသားအဖြစ် မဟုတ်ဘဲ error event အဖြစ် ရောက်လာသည်။ CLI coding tools
- အသစ်
/v1endpoint များ-POST /v1/chat/completions၊POST /v1/messages၊POST /v1/responsesနှင့်GET /v1/models။ OpenAI နှင့် Anthropic SDK များ၊ Claude Code နှင့် Codex CLI တို့ ခေါ်သော endpoint များ ဖြစ်သည်။ အနှစ်ချုပ် - အသစ်
/v1/chat/completionsနှင့်/v1/messagesတွင်toolsဖြင့် tool call များ၊response_formatဖြင့် structured output နှင့်/v1/messagesတွင် string သို့မဟုတ် text block များအဖြစ်system။ လုပ်ဆောင်ချက် ခေါ်ဆိုမှု
- အသစ်
shannon-1.6-liteနှင့်အတူ Model id များshannon-1.6-pro၊shannon-2-lite၊shannon-2-proနှင့်shannon-coder-1။ Model များနှင့် ဈေးနှုန်း
- အသစ်
API ၏ ပထမဆုံး release- OpenAI format နှင့် Anthropic format ဖြင့် chat နှင့် Responses endpoint၊ တစ်ခုစီကို
sk-ဖြင့်စသော API key ဖြင့် ခေါ်သည်။ အတည်ပြုမှု