صلاحیتیں

ہر ماڈل تک انہی تین endpoints سے اسی کلید کے ساتھ پہنچا جاتا ہے۔ دونوں جدول دکھاتے ہیں کہ ماڈلز کہاں مختلف ہیں۔ ڈیش کا مطلب ہے کہ ماڈل اس صلاحیت کے بغیر جواب دیتا ہے۔

Shannon ماڈلز

ہوسٹڈ اوپن ویٹ ماڈلز

ہوسٹڈ ماڈل کا id اس کے نام اور ویریئنٹ کو ہائفن سے جوڑ کر بنتا ہے، مثلاً DeepSeek-V4-Pro-0813-3BIT-REAP۔

ہر کالم کا مطلب

• ٹولز. آپ tools میں فنکشنز بیان کرتے ہیں، ماڈل ان کالز کے ساتھ جواب دیتا ہے جو وہ کروانا چاہتا ہے، اور آپ کا کوڈ انہیں چلاتا ہے۔ ہر ماڈل ٹولز قبول کرتا ہے۔ لازمی tool_choice ہوسٹڈ اوپن ویٹ ماڈلز لاگو کرتے ہیں۔ فنکشن کالنگ
• تصویر ان پٹ. ماڈل صارف کے پیغام میں بھیجی گئی تصاویر پڑھتا ہے، data URL کے طور پر یا پتے کے طور پر۔ shannon-2-lite اور shannon-2-pro ایسی درخواستوں میں بھی تصاویر پڑھتے ہیں جو tools یا response_format بھی بھیجتی ہیں۔ Shannon 3 فیملی دستاویزات بھی پڑھتی ہے۔ تصاویر اور فائلیں
• Reasoning. جواب، اصل جواب کے ساتھ، ماڈل کا reasoning متن اپنے الگ فیلڈ میں لا سکتا ہے۔ Reasoning effort
• Reasoning effort. درخواست کا ایک فیلڈ طے کرتا ہے کہ ماڈل کتنی گہرائی سے reasoning کرے: off، low، medium یا high۔ Shannon ماڈلز اپنی گہرائی خود طے کرتے ہیں۔ Reasoning effort
• 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 کے ساتھ جواب ماڈل کے لکھنے کے دوران server-sent events کے طور پر آتا ہے۔ ہر ماڈل تینوں 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

data کی دو اندراجات کے id اور capabilities:

[
  {
    "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 موڈز کی نمائندگی کرتا ہے۔
• shannon-2-lite اور shannon-2-pro کے لیے vision کی قدر true ہے: وہ ایسی درخواستوں میں بھی تصاویر پڑھتے ہیں جو tools یا response_format بھی بھیجتی ہیں۔

ماڈل کی قطار سے باہر

ہوسٹڈ اوپن ویٹ ماڈل ایسی تصویر یا JSON موڈ مسترد کر دیتا ہے جو اس کی قطار سے باہر ہو۔ انکار آپ کے بیلنس سے کچھ نکالے جانے سے پہلے ہوتا ہے:

Shannon ماڈل ایسی درخواست کا جواب اسٹیٹس 200 سے دیتا ہے: اس کی قطار سے باہر کی صلاحیت جواب میں کوئی کردار ادا نہیں کرتی۔ غلطیاں