قابلیت‌ها

به هر مدل از طریق همان سه endpoint و با همان کلید دسترسی دارید. دو جدول نشان می‌دهند مدل‌ها کجا با هم فرق دارند. خط تیره یعنی مدل بدون آن قابلیت پاسخ می‌دهد.

مدل‌های 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 اسناد را هم می‌خواند. تصاویر و فایل‌ها
• استدلال. پاسخ می‌تواند متن استدلال مدل را در کنار جواب، در یک فیلد جداگانه، همراه داشته باشد. میزان تلاش استدلال
• میزان تلاش استدلال. یک فیلد درخواست تعیین می‌کند مدل تا چه عمقی استدلال کند: off، low، medium یا high. مدل‌های Shannon عمق خود را خودشان تعیین می‌کنند. میزان تلاش استدلال
• شیء JSON. با response_format: {"type": "json_object"} پاسخ JSON بدون ساختار مشخص است. روی /v1/chat/completions و /v1/responses. خروجی‌های ساختاریافته
• JSON schema. با response_format از نوع json_schema پاسخ از schemaای که می‌فرستید پیروی می‌کند. روی /v1/chat/completions و /v1/responses. خروجی‌های ساختاریافته
• کش کردن پرامپت. پرامپتی که مثل یک پرامپت اخیر روی همان مدل شروع شود از کش خوانده می‌شود و بخش کش‌شده با 25% قیمت ورودی محاسبه می‌شود. به هیچ فیلد درخواستی نیاز ندارد. کش کردن پرامپت
• جستجوی وب. با web_search: true API در وب جستجو می‌کند و پیش از پاسخ نتایج را به مدل می‌دهد. روی /v1/chat/completions و /v1/messages. این یک فیلد درخواست است و در GET /v1/models فلگی ندارد. جستجوی وب داخلی
• Streaming. با stream: true پاسخ در حین نوشتن مدل به‌صورت server-sent events می‌رسد. هر مدل روی هر سه endpoint استریم می‌کند. استریم

همین واقعیت‌ها از 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 برای shannon-2-lite و shannon-2-pro برابر true است: آن‌ها تصاویر را در درخواست‌هایی که tools یا response_format هم می‌فرستند می‌خوانند.

خارج از ردیف یک مدل

مدل open-weight میزبانی‌شده تصویر یا حالت JSON خارج از ردیف خودش را رد می‌کند. رد کردن پیش از هر کسری از موجودی شما انجام می‌شود:

مدل Shannon به چنین درخواستی با وضعیت 200 پاسخ می‌دهد: قابلیتی که خارج از ردیف آن است در پاسخ نقشی ندارد. مدیریت خطا