Pêşandanan

هەموو مۆدێلێک لە ڕێگەی هەمان سێ endpoint ەوە بە هەمان کلیل دەستی پێدەگات. دوو خشتەکە پیشان دەدەن مۆدێلەکان لە کوێ جیاوازن. هێڵ واتە مۆدێلەکە بێ ئەو توانایە وەڵام دەداتەوە.

مۆدێلەکانی Shannon

مۆدێلە open-weight هۆستکراوەکان

id ی مۆدێلێکی هۆستکراو ناو و variant ـەکەیەتی بە هێڵی ناوەڕاست بەستراون، بۆ نموونە DeepSeek-V4-Pro-0813-3BIT-REAP.

هەر ستوونێک چی دەگەیەنێت

• ئامرازەکان. تۆ فەنکشنەکان لە tools دا وەسف دەکەیت، مۆدێلەکە بە بانگکردنەکانی دەیەوێت وەڵام دەداتەوە، و کۆدەکەت جێبەجێیان دەکات. هەموو مۆدێلێک ئامراز وەردەگرێت. tool_choice ی زۆرلێکراو لەلایەن مۆدێلە open-weight هۆستکراوەکانەوە جێبەجێ دەکرێت. Bangkirina fonksiyonê
• Input ی وێنە. مۆدێلەکە ئەو وێنانە دەخوێنێتەوە کە لە ناو نامەی بەکارهێنەردا دەنێردرێن، وەک data URL یان وەک ناونیشان. shannon-2-lite و shannon-2-pro وێنە دەخوێننەوە لەو داواکاریانەشدا کە tools یان response_format دەنێرن. بنەماڵەی Shannon 3 دۆکیومێنتیش دەخوێنێتەوە. وێنە و فایلەکان
• بیرکردنەوە. وەڵامەکە دەتوانێت دەقی بیرکردنەوەی مۆدێلەکە لە تەنیشت وەڵامەکە هەڵبگرێت، لە field ێکی تایبەتی خۆیدا. ئاستی بیرکردنەوە
• ئاستی بیرکردنەوە. field ێکی داواکاری دیاری دەکات مۆدێلەکە چەند قووڵ بیر دەکاتەوە: off و low و medium یان high. مۆدێلەکانی Shannon قووڵییی خۆیان خۆیان دیاری دەکەن. ئاستی بیرکردنەوە
• ئۆبجێکتی JSON. لەگەڵ response_format: {"type": "json_object"} وەڵامەکە JSON ە بێ شێوەیەکی دیاریکراو. لەسەر /v1/chat/completions و /v1/responses. Derketinên strukturkirî
• JSON schema. لەگەڵ response_format ی جۆری json_schema وەڵامەکە شوێن schema ێک دەکەوێت کە دەینێریت. لەسەر /v1/chat/completions و /v1/responses. Derketinên strukturkirî
• Prompt caching. prompt ێک کە وەک prompt ی نزیکێک لەسەر هەمان مۆدێل دەست پێبکات لە cache دەخوێندرێتەوە، و بەشە cache کراوەکە بە 25% ی نرخی input حیساب دەکرێت. هیچ field ێکی داواکاری ناوێت. کەشراوکردنی پرۆمپت
• گەڕانی وێب. لەگەڵ web_search: true ی API لە وێب دەگەڕێت و ئەنجامەکان پێش وەڵامدانەوە دەداتە مۆدێلەکە. لەسەر /v1/chat/completions و /v1/messages. field ێکی داواکارییەکەیە و لە GET /v1/models دا flag ی نییە. Lêgerîna webê
• Streaming. لەگەڵ stream: true وەڵامەکە وەک server-sent events دەگات لە کاتی نووسینی مۆدێلەکەدا. هەموو مۆدێلێک لەسەر هەر سێ endpoint ەکە stream دەکات. Streaming

هەمان زانیاری لە GET /v1/models

GET https://api.shannon-ai.com/v1/models

GET /v1/models هەموو مۆدێلێک لیست دەکات لەگەڵ ئۆبجێکتی capabilities، بۆیە بەرنامەیەک دەتوانێت ئەم زانیاریانە بخوێنێتەوە لە جیاتی ئەم لاپەڕەیە. endpoint ەکە کلیلی ناوێت.

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });

for await (const model of client.models.list()) {
  console.log(model.id, model.capabilities);
}

curl https://api.shannon-ai.com/v1/models

id و capabilities ی دوو تۆماری data:

[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]

• response_format و prompt_caching flag ی تۆمارە open-weight هۆستکراوەکانن. تۆماری Shannon دەرچووی JSON تەنها بە json_schema ڕاپۆرت دەکات، کە بۆ هەردوو دۆخی JSON وەستاوە.
• vision بۆ shannon-2-lite و shannon-2-pro یەکسانە بە true: ئەوان وێنە دەخوێننەوە لەو داواکاریانەشدا کە tools یان response_format دەنێرن.

لە دەرەوەی ڕیزی مۆدێلێک

مۆدێلێکی open-weight ی هۆستکراو وێنەیەک یان دۆخێکی JSON ڕەت دەکاتەوە کە لە دەرەوەی ڕیزەکەیەتی. ڕەتکردنەوەکە پێش ئەوە دێت کە هیچ شتێک لە باڵانسەکەت کەم بکرێتەوە:

مۆدێلی Shannon بەم جۆرە داواکارییەک بە دۆخی 200 وەڵام دەداتەوە: ئەو توانایەی لە دەرەوەی ڕیزەکەیەتی بەشداری لە وەڵامەکەدا ناکات. Çewtî