Loga guherandinan
Nûvekirin û baştirinên nêzîk li Shannon API.
ئەم لاپەڕەیە ئەو گۆڕانکاریانە لیست دەکات کە وەک بانگکەری API دەتوانیت ببینیت: endpoint و field و مۆدێلی نوێ، ڕەفتاری گۆڕدراو و چاککردنەوەکان. نوێترین تۆمارەکان یەکەمن. هەر تۆمارێک ئەو بەروارەی هەڵدەگرێت کە گۆڕانکارییەکەی تێدا کرا.
تۆمارێک کە بە Breaking نیشانە کرابێت دەتوانێت ئەنجامی داواکارییەک بگۆڕێت کە پێشتر کاری دەکرد. API ـەکە یەک وەشانی هەیە، /v1، بۆیە گۆڕانکارییەکان بەپێی بەروار لیست دەکرێن نەک بەپێی ژمارەی وەشان.
- Nû
داواکارییەک بە
web_search: trueسەرچاوەکانی ناو دەبات:sourcesلەسەر/v1/chat/completionsو/v1/messagesئەو ئەنجامانە لیست دەکات کە درانە مۆدێلەکە، و لەسەر/v1/chat/completionsannotationsنیشان دەدات وەڵامەکە هەر یەکێکیان لە کوێ ئاماژەی پێ دەکات. Lêgerîna webê
- Nû
web_search: trueلەسەر/v1/chat/completionsو/v1/messagesپێش وەڵامدانەوەی مۆدێلەکە گەڕانی وێب ئەنجام دەدات و ئەنجامەکان وەک سەرچاوەی ژمارەدار پێی دەدات. داواکارییەک کە ئەنجامی دۆزیبێتەوە یەک گەڕان لە بڕی ڕۆژانەکەت بەکاردەهێنێت. ئەگەر هیچ نەمابێت، داواکارییەکە بێ گەڕان وەڵام دەدرێتەوە. Lêgerîna webê
- Rastkirî
stream ێک کە لە لایەن سێرڤەرەوە ببڕدرێت بۆ ئەو usage ـە حیساب دەکرێت کە تا ئەو خاڵە ڕاپۆرت کراوە. ئەوەی لە پاشەکەوتکراوەکە ماوەتەوە بۆ باڵانسەکەت دەگەڕێتەوە.
- Rastkirî
shannon-coder-1لەسەر/v1/responsesوەڵام دەداتەوە هەروەک لەسەر دوو endpoint ی تر. ئامرازەکانی کۆدنووسینی CLI - Rastkirî
کلیلی API ی گۆڕدراو یەکسەر کار ناکات.
- Nû
POST /v1/tokenizeوPOST /v1/messages/count_tokens: ژماردنی بێبەرامبەری تۆکن بۆ مۆدێلە open-weight هۆستکراوەکان. هەژمارکردنی تۆکن - Nû
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ڕاپۆرت دەکات. کەشراوکردنی پرۆمپت - Rastkirî
مۆدێلە open-weight هۆستکراوەکان:
tool_choiceی زۆرلێکراو (requiredیان فەنکشنێکی ناودیارکراو) بانگکردنی ئامراز دەدات. Bangkirina fonksiyonê - Rastkirî
مۆدێلە open-weight هۆستکراوەکان نامەی
systemقبوڵ دەکەن کە یەکەم نامەی گفتوگۆکە نییە.
- Nû
API ـەکە وەک خزمەتگوزاری Tor onion و لە ناونیشانێکی I2P دەستی پێدەگات. وەڵامەکانی
api.shannon-ai.comهەردوو ناونیشانەکە لە header ەکانیOnion-LocationوX-I2P-Locationدا هەڵدەگرن. Endpoint ـە ڕەمزکراوەکان، Tor و I2P
- Nû
مۆدێلە نوێیەکانی
shannon-3.1وshannon-3.1-pro، کەGET /v1/modelsلیستیان دەکات. مۆدێل و نرخ - گۆڕدرا
داواکارییەکی stream کراو کە کلاینتەکەی دەپچڕێت تا کۆتایی کار دەکات و دەژمێردرێت. پێشتر وەڵامەکە لە کاتی پچڕانەکەدا دەوەستا.
- Rastkirî
داواکاریەکانی
/v1/responsesلە تۆماری usage دا دەردەکەون.
- Nû
مۆدێلە 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 - Nû
تۆماری usage تێچووی USD بۆ هەر بانگکردنێک و وەک کۆ پیشان دەدات.
- Têkçûn
بەهای
modelێک کە id ی بڵاوکراوە نەبێت لەسەر هەر سێ endpoint بە400و جۆریinvalid_request_errorو نامەیunknown model: <id>وەڵام دەدرێتەوە. پێشتر ئەم جۆرە داواکارییە لەلایەنshannon-1.6-liteوەڵام دەدرایەوە. مۆدێل و نرخ - Têkçûn
/v1تەنها کلیلی API وەردەگرێت. کووکیی چوونەژوورەوەی ماڵپەڕەکە لەوێ ناخوێندرێتەوە. Rastandin - گۆڕدرا
Flood protection: 120 داواکاری بۆ هەر خولەکێک بۆ هەر هەژمارێک لەسەر سێ endpoint ی دروستکردنەکە. سنوور و باڵانس
- Bihezkirî
کاتێک مۆدێلەکە نەتوانێت وەڵام بداتەوە، هەڵەکە نامەی جێگیری
The model backend failed to answer. Please retry.هەڵدەگرێت. پشکنینی باڵانس کە نەکرێت بە503و جۆریapi_errorوەڵام دەدرێتەوە. Çewtî - Rastkirî
داواکارییەکی بێ-stream کە شکست بخوات پاشەکەوتکراوەکەی بۆ باڵانسەکەت دەگەڕێنێتەوە.
- Nû
GET /v1/modelsبۆ هەر مۆدێلێکcapabilities.reasoning_effortڕاپۆرت دەکات. ئاستی بیرکردنەوە - Bihezkirî
مۆدێلە open-weight هۆستکراوەکان: داواکارییەکی بێ-stream کە هیچ وەڵامێک وەرنەگرێت بە
504و جۆریapi_errorکۆتایی دێت. ئەنجامی بەتاڵ502ە. Çewtî
- Têkçûn
مۆدێلە open-weight هۆستکراوەکان ئەو input ـە وەردەگرن کە مۆدێلە ناودیارکراوەکە وەریدەگرێت. وێنەیەک کە بنێردرێت بۆ id ێکی تەنها-دەق بە
400و<id> does not accept image inputوەڵام دەدرێتەوە.response_formatلەسەر id ێک بێ دەرچووی ڕێکخراو بە400وەڵام دەدرێتەوە.GET /v1/modelsبۆ هەر id ێکcapabilities.visionوresponse_formatوjson_schemaڕاپۆرت دەکات. وێنە و فایلەکان - Rastkirî
وەڵامە بێ-stream ـەکان دەقی بیرکردنەوە هەڵدەگرن:
reasoning_contentلەسەر نامەی/v1/chat/completions، و block یthinkingپێش دەقەکە لەسەر/v1/messages. ئاستی بیرکردنەوە - گۆڕدرا
مۆدێلە open-weight هۆستکراوەکان نرخی نوێیان هەیە، لە $0.50 بۆ هەر 1M تۆکنی input و $2.00 بۆ هەر 1M تۆکنی output. مۆدێل و نرخ
- گۆڕدرا
مۆدێلە open-weight هۆستکراوەکان بۆ هەر مۆدێلێک یەک id یان هەیە، لە کۆیدا دوانزە id. مۆدێل و نرخ
- Nû
دەرچووی ڕێکخراو لەسەر
shannon-3وshannon-3-proوshannon-3.1وshannon-3.1-pro.GET /v1/modelsبۆیانcapabilities.json_schema: trueڕاپۆرت دەکات. Derketinên strukturkirî - Nû
/v1/responsestext.format(json_objectیانjson_schema) بۆ دەرچووی ڕێکخراو دەخوێنێتەوە. Responses API - Rastkirî
/v1/responsesبیرکردنەوەی مۆدێلەکانی Shannon دەگەڕێنێتەوە: بڕگەیەکی دەرچوویreasoningپێش بڕگەیmessage، و ئیڤێنتەکانی stream یresponse.reasoning_summary_text.deltaوresponse.reasoning_summary_text.done. Responses API - Rastkirî
field ی
modelی وەڵامێک لەسەر هەموو endpoint ێک id ی بڵاوکراوەیە. ئۆبجێکتی Responsesmodelوcreated_atهەڵدەگرێت. - Bihezkirî
GET /v1/modelsپەنجەرەی context ی هەر مۆدێلێک ڕاپۆرت دەکات. مۆدێل و نرخ
- Nû
مۆدێلە open-weight هۆستکراوەکان لەسەر
/v1/messagesو/v1/responsesوەڵام دەدەنەوە هەروەک لەسەر/v1/chat/completions، لەگەڵ system prompt و بانگکردنی ئامرازەکانت./v1/messagesthinkingوەردەگرێت، وreasoning_effortfield ێکی داواکارییە. مۆدێل و نرخ - Bihezkirî
body ی هەڵەکان لەسەر
/v1شێوەی SDK ـەکان دەگرنەبەر: ئۆبجێکتیerrorلەگەڵtypeوmessageلەسەر endpoint ەکانی فۆرماتی OpenAI، و هەمان ئۆبجێکت لە ناو{"type": "error"}لەسەر/v1/messages. Çewtî - Nû
Keep-alive لەسەر stream ە کراوەکان هەر 15 چرکە جارێک: هێڵی لێدوانی
: pingلەسەر/v1/chat/completions،event: pingلەسەر/v1/messages. Streaming - گۆڕدرا
id ی بانگکردنی ئامراز لەسەر
/v1/chat/completionsو/v1/responsesبەcall_دەست پێدەکات، و لەسەر/v1/messagesبەtoolu_. Bangkirina fonksiyonê - Têkçûn
/v1/responses:streamبنەڕەتیfalseە. Responses API - Nû
max_completion_tokensوەک ناوێکی تر بۆmax_tokensلەسەر/v1/chat/completionsقبوڵ دەکرێت. Chat Completions - Rastkirî
ئیڤێنتی
response.completedی stream ی Responses array یoutputهەڵدەگرێت. Responses API - Nû
تۆمارەکانی
GET /v1/modelsdisplay_nameوcontext_windowوmax_output_tokensوpricingوcapabilitiesوendpointsهەڵدەگرن. مۆدێل و نرخ - Nû
هەموو وەڵامێک
x-request-idهەڵدەگرێت، و ئەو بەهایەی دەینێریت دەگەڕێتەوە. body ی داواکاری دەتوانێت تا 32 MiB بێت. - Nû
کلیلێک دەکرێت هەڵبوەشێنرێتەوە بێ ئەوەی کلیلێکی نوێ بدرێت. تۆماری usage لاپەڕەلاپەڕە کراوە.
- Nû
وێنە و دۆکیومێنت لە داواکاریدا: بەشەکانی
image_urlلەسەر/v1/chat/completions، block ەکانیimageوdocumentوfileلەسەر/v1/messages، بەشەکانیinput_imageلەسەر/v1/responses. وێنە و فایلەکان - Nû
مۆدێلی نوێی
shannon-3-pro. مۆدێل و نرخ
- Nû
مۆدێلی نوێی
shannon-3. مۆدێل و نرخ - Nû
stream ـەکانی
/v1/chat/completionsبیرکردنەوە وەکdelta.reasoning_contentهەڵدەگرن. ئاستی بیرکردنەوە
- گۆڕدرا
max_tokensلە نێوان 1 تا 65,536 دەهێڵرێتەوە. بەهایەک لە دەرەوەی ئەو مەودایە دەخرێتە نزیکترین کۆتاییەوە، ڕەت ناکرێتەوە. Chat Completions
- Nû
shannon-coder-1لەسەر/v1/chat/completionsو/v1/messagesبە بانگکردن بۆ هەر پلانێک دەژمێردرێت. کاتێک بانگکردنەکانی پەنجەرەیەک تەواو دەبن، وەڵامەکە429ە لەگەڵ نامەیShannon Coder call quota reached. ئامرازەکانی کۆدنووسینی CLI - Nû
گفتوگۆیەک کە لە پەنجەرەی context گەورەتر بێت بە
400وەڵام دەدرێتەوە، لەگەڵ جۆریinvalid_request_errorو کۆدیcontext_length_exceeded. هەڵەیەک لە ناو stream دا وەک ئیڤێنتی هەڵە دەگات، نەک وەک دەق لە ناو وەڵامەکەدا. ئامرازەکانی کۆدنووسینی CLI
- Nû
endpoint ەکانی
/v1:POST /v1/chat/completionsوPOST /v1/messagesوPOST /v1/responsesوGET /v1/models. ئەمانە ئەو endpoint انەن کە SDK ـەکانی OpenAI و Anthropic و Claude Code و Codex CLI بانگیان دەکەن. Têkilî - Nû
بانگکردنی ئامراز بە
toolsلەسەر/v1/chat/completionsو/v1/messages، دەرچووی ڕێکخراو بەresponse_format، وsystemوەک ڕیزبەندی دەق یان وەک block ی دەق لەسەر/v1/messages. Bangkirina fonksiyonê
- Nû
id ی مۆدێلەکانی
shannon-1.6-proوshannon-2-liteوshannon-2-proوshannon-coder-1، لە تەنیشتshannon-1.6-lite. مۆدێل و نرخ
- Nû
یەکەم بڵاوکردنەوەی API: چات بە فۆرماتی OpenAI و بە فۆرماتی Anthropic، و endpoint ی Responses، هەریەکەیان بە کلیلی API ێک بانگ دەکرێت کە بە
sk-دەست پێدەکات. Rastandin