កំណត់ត្រាកែប្រែ
ការធ្វើបច្ចុប្បន្នភាព និងការកែលម្អថ្មីៗនៅក្នុង Shannon API។
ទំព័រនេះរាយការផ្លាស់ប្តូរដែលអ្នកអាចសង្កេតឃើញក្នុងនាមអ្នកហៅ API៖ endpoint, field និងម៉ូដែលថ្មី ឥរិយាបថដែលបានផ្លាស់ប្តូរ និងការជួសជុល។ ធាតុថ្មីបំផុតនៅមុនគេ។ ធាតុនីមួយៗមានកាលបរិច្ឆេទដែលបានធ្វើការផ្លាស់ប្តូរ។
ធាតុដែលសម្គាល់ថា Breaking អាចផ្លាស់ប្តូរលទ្ធផលនៃ request ដែលធ្លាប់ដំណើរការ។ API មានកំណែតែមួយគឺ /v1 ដូច្នេះការផ្លាស់ប្តូរត្រូវបានរាយតាមកាលបរិច្ឆេទ មិនមែនតាមលេខកំណែទេ។
- ថ្មី
request ដែលមាន
web_search: trueដាក់ឈ្មោះប្រភពរបស់វា៖sourcesលើ/v1/chat/completionsនិង/v1/messagesរាយបញ្ជីលទ្ធផលដែលបានប្រគល់ឱ្យម៉ូដែល ហើយលើ/v1/chat/completionsannotationsសម្គាល់កន្លែងដែលចម្លើយដកស្រង់នីមួយៗ។ ស្វែងរកវេបក្នុងស្រាប់
- ថ្មី
web_search: trueលើ/v1/chat/completionsនិង/v1/messagesដំណើរការការស្វែងរកតាមវេបមុនម៉ូដែលឆ្លើយ ហើយប្រគល់លទ្ធផលឱ្យវាជាប្រភពដែលមានលេខរៀង។ request ដែលរកឃើញលទ្ធផលប្រើការស្វែងរកមួយពីកូតាប្រចាំថ្ងៃរបស់អ្នក។ ពេលអស់ហើយ request ត្រូវបានឆ្លើយដោយគ្មានការស្វែងរក។ ស្វែងរកវេបក្នុងស្រាប់
- បានជួសជុល
stream ដែលត្រូវកាត់ខាង server ត្រូវបានគិតថ្លៃតាម usage ដែលបានរាយការណ៍ដល់ចំណុចនោះ។ ការបម្រុងទុកដែលនៅសល់ត្រឡប់ទៅសមតុល្យរបស់អ្នកវិញ។
- បានជួសជុល
shannon-coder-1ឆ្លើយលើ/v1/responsesដូចដែលវាឆ្លើយលើ endpoint ពីរផ្សេងទៀត។ ឧបករណ៍សរសេរកូដ CLI - បានជួសជុល
API key ដែលបានប្តូរឈប់ដំណើរការភ្លាមៗ។
- ថ្មី
POST /v1/tokenizeនិងPOST /v1/messages/count_tokens៖ ការរាប់ token ឥតគិតថ្លៃសម្រាប់ម៉ូដែល open-weight ដែលបង្ហោះ។ ការរាប់ token - ថ្មី
Prompt caching លើម៉ូដែល open-weight ដែលបង្ហោះ។ input ក្នុង cache ត្រូវបានគិតថ្លៃ 25% នៃតម្លៃ input ហើយត្រូវបានរាយការណ៍ក្នុង
usageលើ endpoint ទាំងបី៖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 - បានជួសជុល
ម៉ូដែល open-weight ដែលបង្ហោះ៖
tool_choiceដែលបង្ខំ (requiredឬ function ដែលបានដាក់ឈ្មោះ) ផ្តល់ការហៅ tool។ ការហៅមុខងារ - បានជួសជុល
ម៉ូដែល open-weight ដែលបង្ហោះទទួលសារ
systemដែលមិនមែនជាសារដំបូងនៃការសន្ទនា។
- ថ្មី
អាចចូលប្រើ API បានជា onion service របស់ Tor និងនៅអាសយដ្ឋាន I2P។ ចម្លើយរបស់
api.shannon-ai.comមានអាសយដ្ឋានទាំងពីរក្នុង headerOnion-LocationនិងX-I2P-Location។ Endpoint ដែលបានអ៊ិនគ្រីប, Tor និង I2P
- ថ្មី
ម៉ូដែលថ្មី
shannon-3.1និងshannon-3.1-proដែលរាយដោយGET /v1/models។ ម៉ូដែល និងតម្លៃ - បានផ្លាស់ប្តូរ
request ជា stream ដែល client ផ្តាច់ការតភ្ជាប់ ដំណើរការរហូតដល់ចប់ ហើយត្រូវបានរាប់។ កាលពីមុន ចម្លើយឈប់នៅពេលផ្តាច់។
- បានជួសជុល
Request ទៅ
/v1/responsesលេចឡើងក្នុង usage log។
- ថ្មី
ម៉ូដែល open-weight ដែលបង្ហោះអនុវត្ត field sampling៖
temperature,top_p,seed,stopនិងmax_tokensលើ/v1/chat/completions;temperature,top_pនិងstop_sequencesលើ/v1/messages;temperature,top_pនិងmax_output_tokensលើ/v1/responses។ Chat Completions - ថ្មី
usage log បង្ហាញតម្លៃជា USD សម្រាប់ការហៅនីមួយៗ និងជាផលបូក។
- បំបែក
តម្លៃ
modelដែលមិនមែនជា id ដែលបានផ្សព្វផ្សាយ ត្រូវបានឆ្លើយដោយ400ប្រភេទinvalid_request_errorនិងសារunknown model: <id>លើ endpoint ទាំងបី។ កាលពីមុន request បែបនេះត្រូវបានឆ្លើយដោយshannon-1.6-lite។ ម៉ូដែល និងតម្លៃ - បំបែក
/v1ទទួលតែ API key ប៉ុណ្ណោះ។ cookie នៃការចូលគណនីរបស់វេបសាយមិនត្រូវបានអាននៅទីនោះទេ។ ការផ្ទៀងផ្ទាត់ - បានផ្លាស់ប្តូរ
Flood protection៖ 120 request ក្នុងមួយនាទីក្នុងមួយគណនី លើ endpoint បង្កើតទាំងបី។ ដែនកំណត់ និងសមតុល្យ
- បានកែលម្អ
នៅពេលម៉ូដែលមិនអាចឆ្លើយបាន កំហុសមានសារថេរ
The model backend failed to answer. Please retry.ការត្រួតពិនិត្យសមតុល្យដែលមិនអាចធ្វើបានត្រូវបានឆ្លើយដោយ503និងប្រភេទapi_error។ ការគ្រប់គ្រងកំហុស - បានជួសជុល
request ដែលមិនមែន stream ហើយបរាជ័យ ប្រគល់ការបម្រុងទុករបស់វាត្រឡប់ទៅសមតុល្យរបស់អ្នកវិញ។
- ថ្មី
GET /v1/modelsរាយការណ៍capabilities.reasoning_effortសម្រាប់ម៉ូដែលនីមួយៗ។ កម្រិត reasoning - បានកែលម្អ
ម៉ូដែល open-weight ដែលបង្ហោះ៖ request ដែលមិនមែន stream ហើយមិនទទួលបានចម្លើយបញ្ចប់ដោយ
504និងប្រភេទapi_error។ លទ្ធផលទទេគឺ502។ ការគ្រប់គ្រងកំហុស
- បំបែក
ម៉ូដែល open-weight ដែលបង្ហោះទទួល input ដូចម៉ូដែលដែលបានដាក់ឈ្មោះទទួល។ រូបភាពដែលផ្ញើទៅ id សម្រាប់តែអត្ថបទត្រូវបានឆ្លើយដោយ
400និង<id> does not accept image input។response_formatលើ id ដែលគ្មាន structured output ត្រូវបានឆ្លើយដោយ400។GET /v1/modelsរាយការណ៍capabilities.vision,response_formatនិងjson_schemaសម្រាប់ id នីមួយៗ។ រូបភាព និងឯកសារ - បានជួសជុល
ចម្លើយដែលមិនមែន stream មានអត្ថបទវែកញែក៖
reasoning_contentលើសារនៃ/v1/chat/completionsនិង blockthinkingមុនអត្ថបទលើ/v1/messages។ កម្រិត reasoning - បានផ្លាស់ប្តូរ
ម៉ូដែល open-weight ដែលបង្ហោះមានតម្លៃថ្មី ចាប់ពី $0.50 ក្នុង 1M input token និង $2.00 ក្នុង 1M output token។ ម៉ូដែល និងតម្លៃ
- បានផ្លាស់ប្តូរ
ម៉ូដែល open-weight ដែលបង្ហោះមាន id មួយក្នុងមួយម៉ូដែល សរុបដប់ពីរ id។ ម៉ូដែល និងតម្លៃ
- ថ្មី
Structured output លើ
shannon-3,shannon-3-pro,shannon-3.1និងshannon-3.1-pro។GET /v1/modelsរាយការណ៍capabilities.json_schema: trueសម្រាប់ពួកវា។ លទ្ធផលមានរចនាសម្ព័ន្ធ - ថ្មី
/v1/responsesអានtext.format(json_objectឬjson_schema) សម្រាប់ structured output។ Responses API - បានជួសជុល
/v1/responsesប្រគល់ការវែកញែករបស់ម៉ូដែល Shannon៖ ធាតុ outputreasoningមុនធាតុmessageនិង event ក្នុង streamresponse.reasoning_summary_text.deltaនិងresponse.reasoning_summary_text.done។ Responses API - បានជួសជុល
field
modelនៃចម្លើយគឺជា id ដែលបានផ្សព្វផ្សាយលើគ្រប់ endpoint។ object Responses មានmodelនិងcreated_at។ - បានកែលម្អ
GET /v1/modelsរាយការណ៍ context window នៃម៉ូដែលនីមួយៗ។ ម៉ូដែល និងតម្លៃ
- ថ្មី
ម៉ូដែល open-weight ដែលបង្ហោះឆ្លើយលើ
/v1/messagesនិង/v1/responsesព្រមទាំងលើ/v1/chat/completionsជាមួយ system prompt និងការហៅ tool របស់អ្នក។/v1/messagesទទួលthinkingហើយreasoning_effortជា field របស់ request។ ម៉ូដែល និងតម្លៃ - បានកែលម្អ
ខ្លឹមសារកំហុសលើ
/v1ធ្វើតាមរូបរាងរបស់ SDK៖ objecterrorដែលមានtypeនិងmessageលើ endpoint ទ្រង់ទ្រាយ OpenAI និង object ដូចគ្នាក្នុង{"type": "error"}លើ/v1/messages។ ការគ្រប់គ្រងកំហុស - ថ្មី
Keep-alive លើ stream ដែលបើកគ្រប់ 15 វិនាទី៖ បន្ទាត់មតិយោបល់
: pingលើ/v1/chat/completionsនិងevent: pingលើ/v1/messages។ ស្ទ្រីម - បានផ្លាស់ប្តូរ
id នៃការហៅ tool ចាប់ផ្តើមដោយ
call_លើ/v1/chat/completionsនិង/v1/responsesហើយដោយtoolu_លើ/v1/messages។ ការហៅមុខងារ - បំបែក
/v1/responses៖streamលំនាំដើមគឺfalse។ Responses API - ថ្មី
max_completion_tokensត្រូវបានទទួលយកជាឈ្មោះមួយទៀតនៃmax_tokensលើ/v1/chat/completions។ Chat Completions - បានជួសជុល
event
response.completedរបស់ stream Responses មានអារេoutputផងដែរ។ Responses API - ថ្មី
ធាតុ
GET /v1/modelsមានdisplay_name,context_window,max_output_tokens,pricing,capabilitiesនិងendpoints។ ម៉ូដែល និងតម្លៃ - ថ្មី
រាល់ចម្លើយមាន
x-request-idហើយតម្លៃដែលអ្នកផ្ញើត្រូវបានត្រឡប់មកវិញ។ ខ្លឹមសារ request អាចមានទំហំរហូតដល់ 32 MiB។ - ថ្មី
key អាចត្រូវបានដកហូតដោយមិនចេញ key ថ្មី។ usage log ត្រូវបានចែកជាទំព័រ។
- ថ្មី
រូបភាព និងឯកសារក្នុង request៖ ផ្នែក
image_urlលើ/v1/chat/completions, blockimage,documentនិងfileលើ/v1/messages, ផ្នែកinput_imageលើ/v1/responses។ រូបភាព និងឯកសារ - ថ្មី
ម៉ូដែលថ្មី
shannon-3-pro។ ម៉ូដែល និងតម្លៃ
- ថ្មី
ម៉ូដែលថ្មី
shannon-3។ ម៉ូដែល និងតម្លៃ - ថ្មី
Stream លើ
/v1/chat/completionsមានការវែកញែកជាdelta.reasoning_content។ កម្រិត reasoning
- បានផ្លាស់ប្តូរ
max_tokensត្រូវបានរក្សាក្នុងចន្លោះ 1 ដល់ 65,536។ តម្លៃក្រៅចន្លោះនោះត្រូវបានរុញទៅចុងជិតបំផុត មិនត្រូវបានបដិសេធទេ។ Chat Completions
- ថ្មី
shannon-coder-1ត្រូវបានរាប់ជាចំនួនការហៅក្នុងមួយគម្រោង លើ/v1/chat/completionsនិង/v1/messages។ នៅពេលការហៅក្នុងចន្លោះពេលមួយត្រូវបានប្រើអស់ ចម្លើយគឺ429ជាមួយសារShannon Coder call quota reached។ ឧបករណ៍សរសេរកូដ CLI - ថ្មី
ការសន្ទនាដែលធំជាង context window ត្រូវបានឆ្លើយដោយ
400ប្រភេទinvalid_request_errorនិងកូដcontext_length_exceeded។ កំហុសក្នុង stream មកដល់ជា event កំហុស មិនមែនជាអត្ថបទក្នុងចម្លើយទេ។ ឧបករណ៍សរសេរកូដ CLI
- ថ្មី
endpoint
/v1៖POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesនិងGET /v1/models។ ទាំងនេះជា endpoint ដែល SDK របស់ OpenAI និង Anthropic, Claude Code និង Codex CLI ហៅ។ ទិដ្ឋភាពទូទៅ - ថ្មី
ការហៅ tool ដោយ
toolsលើ/v1/chat/completionsនិង/v1/messages, structured output ដោយresponse_formatនិងsystemជា string ឬជា text block លើ/v1/messages។ ការហៅមុខងារ
- ថ្មី
Model id
shannon-1.6-pro,shannon-2-lite,shannon-2-proនិងshannon-coder-1នៅជាមួយshannon-1.6-lite។ ម៉ូដែល និងតម្លៃ
- ថ្មី
ការចេញផ្សាយ API លើកដំបូង៖ chat ក្នុងទ្រង់ទ្រាយ OpenAI និងទ្រង់ទ្រាយ Anthropic និង endpoint Responses ដែលនីមួយៗហៅដោយ API key ដែលចាប់ផ្តើមដោយ
sk-។ ការផ្ទៀងផ្ទាត់