រំលងទៅមាតិកា
កំណត់ត្រាកែប្រែ

កំណត់ត្រាកែប្រែ

ការធ្វើបច្ចុប្បន្នភាព និងការកែលម្អថ្មីៗនៅក្នុង Shannon API។

ទំព័រនេះរាយការផ្លាស់ប្តូរដែលអ្នកអាចសង្កេតឃើញក្នុងនាមអ្នកហៅ API៖ endpoint, field និងម៉ូដែលថ្មី ឥរិយាបថដែលបានផ្លាស់ប្តូរ និងការជួសជុល។ ធាតុថ្មីបំផុតនៅមុនគេ។ ធាតុនីមួយៗមានកាលបរិច្ឆេទដែលបានធ្វើការផ្លាស់ប្តូរ។

ធាតុដែលសម្គាល់ថា Breaking អាចផ្លាស់ប្តូរលទ្ធផលនៃ request ដែលធ្លាប់ដំណើរការ។ API មានកំណែតែមួយគឺ /v1 ដូច្នេះការផ្លាស់ប្តូរត្រូវបានរាយតាមកាលបរិច្ឆេទ មិនមែនតាមលេខកំណែទេ។

  • ថ្មី

    request ដែលមាន web_search: true ដាក់ឈ្មោះប្រភពរបស់វា៖ sources លើ /v1/chat/completions និង /v1/messages រាយបញ្ជីលទ្ធផលដែលបានប្រគល់ឱ្យម៉ូដែល ហើយលើ /v1/chat/completions annotations សម្គាល់កន្លែងដែលចម្លើយដកស្រង់នីមួយៗ។ ស្វែងរកវេបក្នុងស្រាប់

  • ថ្មី

    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 មានអាសយដ្ឋានទាំងពីរក្នុង header Onion-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 និង block thinking មុនអត្ថបទលើ /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៖ ធាតុ output reasoning មុនធាតុ message និង event ក្នុង stream response.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៖ object error ដែលមាន 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 ត្រូវបានចែកជាទំព័រ។

  • បានផ្លាស់ប្តូរ

    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។ ការហៅមុខងារ

  • ថ្មី

    ការចេញផ្សាយ API លើកដំបូង៖ chat ក្នុងទ្រង់ទ្រាយ OpenAI និងទ្រង់ទ្រាយ Anthropic និង endpoint Responses ដែលនីមួយៗហៅដោយ API key ដែលចាប់ផ្តើមដោយ sk-។ ការផ្ទៀងផ្ទាត់