الإمكانات

يُوصل إلى كل نموذج عبر نقاط النهاية الثلاث نفسها وبالمفتاح نفسه. يبيّن الجدولان أين تختلف النماذج. وتعني الشرطة أن النموذج يجيب دون تلك القدرة.

نماذج Shannon

النماذج المفتوحة الأوزان المستضافة

معرّف النموذج المستضاف هو اسمه ونوعه مربوطين بواصلة، مثل DeepSeek-V4-Pro-0813-3BIT-REAP.

معنى كل عمود

• الأدوات. تصف الدوال في tools، فيرد النموذج بالاستدعاءات التي يريد تنفيذها، وتشغّلها شيفرتك. كل نموذج يقبل الأدوات. وتطبّق النماذج المفتوحة الأوزان المستضافة قيمة tool_choice المفروضة. استدعاء الدوال
• إدخال الصور. يقرأ النموذج الصور المرسلة داخل رسالة المستخدم، كرابط بيانات (data 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. مع response_format من النوع json_schema تتبع الإجابة مخططاً ترسله. على /v1/chat/completions و/v1/responses. مخرجات منظمة
• التخزين المؤقت للمطالبات. المطالبة التي تبدأ مثل مطالبة حديثة على النموذج نفسه تُقرأ من ذاكرة التخزين المؤقت، ويُحاسَب الجزء المخبأ بنسبة 25% من سعر المدخلات. ولا تحتاج حقلاً في الطلب. التخزين المؤقت للمطالبات
• البحث في الويب. مع web_search: true تبحث API في الويب وتعطي النتائج للنموذج قبل أن يجيب. على /v1/chat/completions و/v1/messages. وهو حقل في الطلب وليس له علم في GET /v1/models. بحث ويب مدمج
• البث. مع stream: true يصل الرد كأحداث يرسلها الخادم (server-sent events) أثناء كتابة النموذج. كل نموذج يبث على نقاط النهاية الثلاث. البث

الحقائق نفسها من 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))

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 علمان في عناصر النماذج المفتوحة الأوزان المستضافة. أما عنصر Shannon فيعلن عن مخرجات JSON بالعلم json_schema وحده، وهو يمثل وضعي JSON معاً.
• قيمة vision هي true للنموذجين shannon-2-lite وshannon-2-pro: يقرآن الصور في الطلبات التي ترسل أيضاً tools أو response_format.

خارج صف النموذج

يرفض النموذج المفتوح الأوزان المستضاف صورة أو وضع JSON خارج صفه. ويأتي الرفض قبل خصم أي شيء من رصيدك:

يجيب نموذج Shannon على طلب كهذا بالحالة 200: القدرة الخارجة عن صفه لا تشارك في الإجابة. معالجة الأخطاء