ক্ষমতাসমূহ

প্রতিটি মডেলে একই key দিয়ে একই তিনটি এন্ডপয়েন্টের মাধ্যমে পৌঁছানো যায়। দুটি টেবিলে দেখানো হয়েছে মডেলগুলো কোথায় আলাদা। ড্যাশের অর্থ মডেলটি সেই সক্ষমতা ছাড়াই উত্তর দেয়।

Shannon মডেল

হোস্টেড ওপেন-ওয়েট মডেল

হোস্টেড মডেলের id হলো তার নাম ও ভ্যারিয়েন্ট হাইফেন দিয়ে জোড়া লাগানো, যেমন DeepSeek-V4-Pro-0813-3BIT-REAP।

প্রতিটি কলামের অর্থ

• টুলস. আপনি tools-এ ফাংশন বর্ণনা করেন, মডেল যে কলগুলো করাতে চায় সেগুলো উত্তরে দেয়, এবং আপনার কোড সেগুলো চালায়। প্রতিটি মডেল টুল নেয়। বাধ্যতামূলক tool_choice হোস্টেড ওপেন-ওয়েট মডেলগুলো প্রয়োগ করে। ফাংশন কলিং
• ইমেজ ইনপুট. মডেল ইউজার মেসেজের ভেতরে পাঠানো ইমেজ পড়ে, data URL হিসেবে বা ঠিকানা হিসেবে। shannon-2-lite ও shannon-2-pro যেসব রিকোয়েস্ট tools বা response_format-ও পাঠায় সেগুলোতেও ইমেজ পড়ে। Shannon 3 ফ্যামিলি ডকুমেন্টও পড়ে। ইমেজ ও ফাইল
• রিজনিং. উত্তর মডেলের রিজনিং টেক্সট উত্তরের পাশে আলাদা একটি ফিল্ডে বহন করতে পারে। রিজনিং effort
• রিজনিং effort. একটি রিকোয়েস্ট ফিল্ড ঠিক করে মডেল কতটা গভীরভাবে রিজনিং করবে: off, low, medium বা high। Shannon মডেলগুলো নিজেরাই গভীরতা ঠিক করে। রিজনিং effort
• JSON অবজেক্ট. response_format: {"type": "json_object"} দিলে উত্তর হয় নির্দিষ্ট কাঠামো ছাড়া JSON। /v1/chat/completions ও /v1/responses-এ। স্ট্রাকচার্ড আউটপুট
• JSON schema. json_schema টাইপের response_format দিলে উত্তর আপনার পাঠানো 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 অবজেক্ট সহ তালিকাভুক্ত করে, যাতে একটি প্রোগ্রাম এই পেজের বদলে এই তথ্যগুলো পড়তে পারে। এন্ডপয়েন্টটির জন্য কোনো key লাগে না।

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_schema দিয়ে JSON আউটপুট জানায়, যা দুটি JSON মোডকেই বোঝায়।
• shannon-2-lite ও shannon-2-pro-র জন্য vision হলো true: যেসব রিকোয়েস্ট tools বা response_format-ও পাঠায় সেগুলোতেও এরা ইমেজ পড়ে।

মডেলের সারির বাইরে

হোস্টেড ওপেন-ওয়েট মডেল তার সারির বাইরের ইমেজ বা JSON মোড প্রত্যাখ্যান করে। প্রত্যাখ্যান আসে আপনার ব্যালেন্স থেকে কিছু কাটার আগেই:

Shannon মডেল এমন রিকোয়েস্টের উত্তর দেয় স্ট্যাটাস 200 দিয়ে: তার সারির বাইরের সক্ষমতা উত্তরে কোনো ভূমিকা রাখে না। এরর হ্যান্ডলিং