შესაძლებლობები

ყველა მოდელს ერთი და იგივე სამი endpoint-ითა და ერთი გასაღებით წვდებით. ორი ცხრილი აჩვენებს, სად განსხვავდებიან მოდელები. ტირე ნიშნავს, რომ მოდელი ამ შესაძლებლობის გარეშე პასუხობს.

Shannon მოდელები

Hosted open-weight მოდელები

Hosted მოდელის id არის მისი სახელი და ვარიანტი, დეფისით შეერთებული, მაგალითად DeepSeek-V4-Pro-0813-3BIT-REAP.

რას ნიშნავს თითოეული სვეტი

• ინსტრუმენტები. ფუნქციებს tools-ში აღწერთ, მოდელი პასუხობს გამოძახებებით, რომელთა შესრულებაც უნდა, და თქვენი კოდი მათ ასრულებს. ყველა მოდელი იღებს ინსტრუმენტებს. იძულებით tool_choice-ს hosted open-weight მოდელები ითვალისწინებენ. ფუნქციის გამოძახება
• სურათის შეტანა. მოდელი კითხულობს user შეტყობინებაში გაგზავნილ სურათებს, 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 სქემა. 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-ის სახით მოდის, სანამ მოდელი წერს. ყველა მოდელი სტრიმს სამივე 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

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 hosted open-weight ჩანაწერების ფლაგებია. Shannon-ის ჩანაწერი JSON გამოტანას მხოლოდ json_schema-თი აჩვენებს, რომელიც ორივე JSON რეჟიმს ნიშნავს.
• vision არის true მოდელებისთვის shannon-2-lite და shannon-2-pro: ისინი სურათებს კითხულობენ იმ მოთხოვნებშიც, რომლებიც tools-ს ან response_format-ს აგზავნიან.

მოდელის სტრიქონის გარეთ

Hosted open-weight მოდელი უარყოფს სურათს ან JSON რეჟიმს, რომელიც მისი სტრიქონის გარეთაა. უარყოფა ხდება მანამ, სანამ თქვენი ბალანსიდან რამეს ჩამოაკლებენ:

Shannon-ის მოდელი ასეთ მოთხოვნას პასუხობს სტატუსით 200: შესაძლებლობა, რომელიც მისი სტრიქონის გარეთაა, პასუხში მონაწილეობას არ იღებს. შეცდომების დამუშავება