सामग्रीमा जानुहोस्
क्षमताहरू

क्षमताहरू

API मार्फत हरेक मोडलले के गर्न सक्छ, मोडल अनुसार: टुल, छवि इनपुट, रिजनिङ, JSON आउटपुट, प्रम्प्ट क्याशिङ, वेब खोज र स्ट्रिमिङ।

हरेक मोडलमा उही तीन इन्डपोइन्ट र उही कीबाट पुगिन्छ। दुई तालिकाले मोडलहरू कहाँ फरक छन् भन्ने देखाउँछन्। ड्यासको अर्थ मोडलले त्यो क्षमता बिना जवाफ दिन्छ।

Shannon मोडलहरू

मोडल टुलहरूछविहरूरिजनिङएफर्टJSON अब्जेक्टJSON स्कीमाक्याशिङखोजस्ट्रिमिङ
shannon-1.6-lite होहो——होहो—होहो
shannon-1.6-pro होहोहो—होहो—होहो
shannon-2-lite हो—हो—होहो—होहो
shannon-2-pro हो—हो—होहो—होहो
shannon-3 होहोहो—होहो—होहो
shannon-3-pro होहोहो—होहो—होहो
shannon-3.1 होहोहो—होहो—होहो
shannon-3.1-pro होहोहो—होहो—होहो
shannon-3.5 हो———होहो——हो
shannon-coder-1 हो—हो—होहो——हो

होस्ट गरिएका ओपन-वेट मोडलहरू

होस्ट गरिएको मोडलको id यसको नाम र भेरियन्टलाई हाइफनले जोडेर बन्छ, उदाहरणका लागि DeepSeek-V4-Pro-0813-3BIT-REAP।

मोडल टुलहरूछविहरूरिजनिङएफर्टJSON अब्जेक्टJSON स्कीमाक्याशिङखोजस्ट्रिमिङ
DeepSeek-V4-Pro-0813 3BIT-REAP हो—होहोहोहोहो—हो
GLM-5.2 3BIT-REAP हो—होहोहोहोहो—हो
Kimi-K3 3BIT-REAP होहोहोहोहोहोहो—हो
Nemotron3Ultra 3BIT-REAP हो—होहोहोहोहो—हो
MiniMax-M3 3BIT-REAP होहोहोहोहोहोहो—हो
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP हो—होहोहोहोहो—हो
Kimi-K2.6 W4A16-AUTOROUND-REAP होहोहोहोहोहोहो—हो
Laguna-S-2.1 W4A16-AUTOROUND-REAP हो—होहो——हो—हो
inkling W4A16-AUTOROUND-REAP होहोहोहोहो—हो—हो
MiMo-V2.5-Pro W8A16 हो—होहोहोहोहो—हो
MiMo-V2.5 W8A16 होहोहोहोहोहोहो—हो
Hy3 W8A16 हो—होहोहोहोहो—हो

प्रत्येक स्तम्भको अर्थ

  • टुलहरू. तपाईंले tools मा फङ्सनहरू वर्णन गर्नुहुन्छ, मोडलले गर्न चाहेका कलहरू जवाफमा दिन्छ, र तपाईंको कोडले तिनलाई चलाउँछ। हरेक मोडलले टुल लिन्छ। जबरजस्ती tool_choice होस्ट गरिएका ओपन-वेट मोडलहरूले लागू गर्छन्। फङ्क्शन कलिङ
  • छवि इनपुट. मोडलले प्रयोगकर्ता सन्देशभित्र पठाइएका छविहरू पढ्छ, डेटा URL वा ठेगानाका रूपमा। shannon-2-lite र shannon-2-pro ले tools वा response_format पनि पठाइएका अनुरोधहरूमा छवि पढ्छन्। Shannon 3 परिवारले कागजातहरू पनि पढ्छ। छवि र फाइलहरू
  • रिजनिङ. जवाफले उत्तरको छेउमा मोडलको रिजनिङ टेक्स्ट आफ्नै फिल्डमा बोक्न सक्छ। रिजनिङ एफर्ट
  • रिजनिङ एफर्ट. अनुरोध फिल्डले मोडलले कति गहिरो रिजनिङ गर्छ भनी सेट गर्छ: off, low, medium वा high। Shannon मोडलहरूले आफ्नै गहिराइ सेट गर्छन्। रिजनिङ एफर्ट
  • JSON अब्जेक्ट. response_format: {"type": "json_object"} सँग उत्तर तोकिएको आकार बिनाको JSON हुन्छ। /v1/chat/completions र /v1/responses मा। संरचित आउटपुट
  • JSON स्कीमा. json_schema प्रकारको response_format सँग उत्तरले तपाईंले पठाएको स्कीमा पछ्याउँछ। /v1/chat/completions र /v1/responses मा। संरचित आउटपुट
  • प्रम्प्ट क्याशिङ. उही मोडलमा हालैको प्रम्प्टजस्तै सुरु हुने प्रम्प्ट क्याशबाट पढिन्छ, र क्याश्ड भागलाई इनपुट मूल्यको 25% मा बिल गरिन्छ। यसलाई कुनै अनुरोध फिल्ड चाहिँदैन। प्रम्प्ट क्याशिङ
  • वेब खोज. web_search: true सँग API ले वेबमा खोज्छ र उत्तर दिनु अघि नतिजा मोडललाई दिन्छ। /v1/chat/completions र /v1/messages मा। यो अनुरोधको फिल्ड हो र GET /v1/models मा यसको कुनै फ्ल्याग छैन। निर्मित वेब खोज
  • स्ट्रिमिङ. stream: true सँग मोडलले लेखिरहँदा जवाफ सर्भर-सेन्ट इभेन्टका रूपमा आइपुग्छ। हरेक मोडलले तीनवटै इन्डपोइन्टमा स्ट्रिम गर्छ। स्ट्रिमिङ

GET /v1/models बाट उही तथ्यहरू

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

GET /v1/models ले हरेक मोडललाई capabilities अब्जेक्टसहित सूचीबद्ध गर्छ, ताकि प्रोग्रामले यो पेजको सट्टा यी तथ्यहरू पढ्न सकोस्। इन्डपोइन्टलाई की चाहिँदैन।

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))

data का दुई प्रविष्टिका id र capabilities:

200 JSON
[
  {
    "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
    }
  }
]
स्तम्भ capabilities मा फ्ल्याग
टुलहरू tools
छवि इनपुट vision
रिजनिङ reasoning
रिजनिङ एफर्ट reasoning_effort
JSON अब्जेक्ट response_format
JSON स्कीमा json_schema
प्रम्प्ट क्याशिङ prompt_caching
वेब खोज फ्ल्याग होइन: अनुरोध फिल्ड web_search।
स्ट्रिमिङ streaming
  • response_format र prompt_caching होस्ट गरिएका ओपन-वेट प्रविष्टिहरूका फ्ल्याग हुन्। Shannon प्रविष्टिले JSON आउटपुटलाई केवल json_schema ले रिपोर्ट गर्छ, जसले दुवै JSON मोडलाई जनाउँछ।
  • shannon-2-lite र shannon-2-pro का लागि vision true हो: तिनले tools वा response_format पनि पठाउने अनुरोधहरूमा छवि पढ्छन्।

मोडलको पङ्क्तिबाहिर

होस्ट गरिएको ओपन-वेट मोडलले आफ्नो पङ्क्तिबाहिरको छवि वा JSON मोड अस्वीकार गर्छ। अस्वीकार तपाईंको ब्यालेन्सबाट केही घटाइनु अघि नै हुन्छ:

स्थिति प्रकार सन्देश कहिले
400 invalid_request_error <id> does not accept image input छवि इनपुट नभएको होस्ट गरिएको ओपन-वेट मोडलमा छवि पठाइयो।
400 invalid_request_error <id> does not accept response_format दुवै JSON मोड नभएको होस्ट गरिएको ओपन-वेट मोडललाई JSON आउटपुट माग गरियो।
400 invalid_request_error <id> does not accept response_format json_schema; use json_object केवल JSON अब्जेक्ट मोड भएको होस्ट गरिएको ओपन-वेट मोडलमा स्कीमा पठाइयो।

Shannon मोडलले यस्तो अनुरोधलाई स्थिति 200 ले जवाफ दिन्छ: आफ्नो पङ्क्तिबाहिरको क्षमताले उत्तरमा भाग लिँदैन। त्रुटि व्यवस्थापन