יכולות

לכל מודל מגיעים דרך אותם שלושה endpoints עם אותו מפתח. שתי הטבלאות מראות במה המודלים שונים. מקף אומר שהמודל עונה בלי היכולת הזו.

מודלי Shannon

מודלי open-weight מתארחים

המזהה של מודל מתארח הוא שמו והווריאנט שלו מחוברים במקף, למשל DeepSeek-V4-Pro-0813-3BIT-REAP.

מה כל עמודה אומרת

• כלים. אתם מתארים פונקציות ב-tools, המודל משיב עם הקריאות שהוא רוצה שיבוצעו, והקוד שלכם מריץ אותן. כל מודל מקבל כלים. tool_choice כפוי מיושם על ידי מודלי ה-open-weight המתארחים. קריאת פונקציות
• קלט תמונה. המודל קורא תמונות שנשלחות בתוך הודעת משתמש, כ-data URL או ככתובת. shannon-2-lite ו-shannon-2-pro קוראים תמונות גם בבקשות ששולחות tools או response_format. משפחת Shannon 3 קוראת גם מסמכים. תמונות וקבצים
• Reasoning. התשובה יכולה לשאת את טקסט ה-reasoning של המודל לצד התשובה, בשדה נפרד. רמת מאמץ ה-reasoning
• רמת מאמץ reasoning. שדה בבקשה קובע כמה לעומק המודל מנמק: off, low, medium או high. מודלי Shannon קובעים עומק משלהם. רמת מאמץ ה-reasoning
• אובייקט JSON. עם response_format: {"type": "json_object"} התשובה היא JSON ללא מבנה קבוע מראש. ב-/v1/chat/completions וב-/v1/responses. פלט מובנה
• סכמת JSON. עם response_format מסוג json_schema התשובה עוקבת אחרי סכמה שאתם שולחים. ב-/v1/chat/completions וב-/v1/responses. פלט מובנה
• מטמון פרומפטים. פרומפט שמתחיל כמו פרומפט אחרון באותו מודל נקרא מהמטמון, והחלק שבמטמון מחויב ב-25% ממחיר הקלט. הוא אינו צריך שדה בבקשה. מטמון פרומפטים (Prompt caching)
• חיפוש ברשת. עם web_search: true ה-API מחפש ברשת ונותן למודל את התוצאות לפני שהוא עונה. ב-/v1/chat/completions וב-/v1/messages. זה שדה של הבקשה ואין לו דגל ב-GET /v1/models. חיפוש ווב מובנה
• Streaming. עם stream: true התשובה מגיעה כ-server-sent events בזמן שהמודל כותב. כל מודל תומך ב-streaming בכל שלושת ה-endpoints. הזרמה

אותן עובדות מ-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 הם דגלים של פריטי ה-open-weight המתארחים. פריט Shannon מדווח על פלט JSON עם json_schema בלבד, שמייצג את שני מצבי ה-JSON.
• vision הוא true עבור shannon-2-lite ו-shannon-2-pro: הם קוראים תמונות גם בבקשות ששולחות tools או response_format.

מחוץ לשורה של מודל

מודל open-weight מתארח דוחה תמונה או מצב JSON שמחוץ לשורה שלו. הדחייה באה לפני שמשהו נגרע מהיתרה שלכם:

מודל Shannon עונה לבקשה כזו בסטטוס 200: היכולת שמחוץ לשורה שלו לא משתתפת בתשובה. טיפול בשגיאות