အကြောင်းအရာသို့ ကျော်သွားရန်
ပြောင်းလဲမှု မှတ်တမ်း

ပြောင်းလဲမှု မှတ်တမ်း

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 မဟုတ်သော system message ကို လက်ခံသည်။

  • အသစ်

    API ကို Tor onion service အဖြစ်နှင့် I2P လိပ်စာတွင် ချိတ်ဆက်နိုင်သည်။ api.shannon-ai.com ၏ reply များတွင် လိပ်စာနှစ်ခုကို Onion-Location နှင့် X-I2P-Location header များဖြင့် ပေးသည်။ 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၊ type invalid_request_error နှင့် message unknown 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 နှင့် type api_error ဖြင့် ဖြေကြားသည်။ အမှားကိုင်တွယ်မှု

  • ပြင်ဆင်

    မအောင်မြင်သော non-streamed request သည် ၎င်း၏ ကြိုတင်ထားရှိမှု (reservation) ကို သင့်လက်ကျန်သို့ ပြန်ပေးသည်။

  • အသစ်

    GET /v1/models သည် မော်ဒယ်တစ်ခုစီအတွက် capabilities.reasoning_effort ကို ဖော်ပြသည်။ Reasoning effort

  • တိုးတက်

    Host လုပ်ထားသော open-weight မော်ဒယ်များ- အဖြေမရသော non-streamed request သည် 504 နှင့် type api_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 တွင် စာသားမတိုင်မီ thinking block။ 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 ကို ပြန်ပေးသည်- message item မတိုင်မီ reasoning output item နှင့် stream event များ response.reasoning_summary_text.delta နှင့် response.reasoning_summary_text.done။ Responses API

  • ပြင်ဆင်

    Reply ၏ model field သည် 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 ပါသော error object၊ /v1/messages တွင် {"type": "error"} အတွင်း တူညီသော object။ အမှားကိုင်တွယ်မှု

  • အသစ်

    ဖွင့်ထားသော stream များတွင် 15 စက္ကန့်တိုင်း keep-alive- /v1/chat/completions တွင် : ping comment လိုင်း၊ /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.completed event တွင် output array ပါဝင်သည်။ Responses API

  • အသစ်

    GET /v1/models entry များတွင် display_name၊ context_window၊ max_output_tokens၊ pricing၊ capabilities နှင့် endpoints ပါဝင်သည်။ Model များနှင့် ဈေးနှုန်း

  • အသစ်

    Reply တိုင်းတွင် x-request-id ပါဝင်ပြီး သင်ပို့သော တန်ဖိုးကို ပြန်ပေးသည်။ Request body များသည် 32 MiB အထိ ရှိနိုင်သည်။

  • အသစ်

    Key အသစ်မထုတ်ဘဲ key တစ်ခုကို ပယ်ဖျက်နိုင်သည်။ Usage log ကို စာမျက်နှာခွဲထားသည်။

  • ပြောင်းလဲသည်

    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၊ type invalid_request_error နှင့် code context_length_exceeded ဖြင့် ဖြေကြားသည်။ Stream အတွင်းရှိ error သည် အဖြေထဲရှိ စာသားအဖြစ် မဟုတ်ဘဲ error event အဖြစ် ရောက်လာသည်။ CLI coding tools

  • အသစ်

    /v1 endpoint များ- 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။ လုပ်ဆောင်ချက် ခေါ်ဆိုမှု

  • အသစ်

    API ၏ ပထမဆုံး release- OpenAI format နှင့် Anthropic format ဖြင့် chat နှင့် Responses endpoint၊ တစ်ခုစီကို sk- ဖြင့်စသော API key ဖြင့် ခေါ်သည်။ အတည်ပြုမှု