Имконот

Ба ҳар модел тавассути ҳамон се endpoint бо ҳамон калид дастрас мешавед. Ду ҷадвал нишон медиҳанд, ки моделҳо дар куҷо фарқ мекунанд. Хат маънои онро дорад, ки модел бе ин имконият ҷавоб медиҳад.

Моделҳои Shannon

Моделҳои open-weight-и хостшуда

Id-и модели хостшуда номи он ва варианташ аст, ки бо дефис пайваст шудаанд, масалан 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. Майдони дархост муайян мекунад, ки модел то чӣ андоза амиқ reasoning мекунад: off, low, medium ё high. Моделҳои Shannon амиқии худро худашон муайян мекунанд. Сатҳи кӯшиши reasoning
• Объекти JSON. Бо response_format: {"type": "json_object"} ҷавоб JSON бе шакли муқарраршуда аст. Дар /v1/chat/completions ва /v1/responses. Баромадҳои сохторӣ
• JSON schema. Бо response_format-и навъи json_schema ҷавоб схемаеро, ки шумо мефиристед, пайравӣ мекунад. Дар /v1/chat/completions ва /v1/responses. Баромадҳои сохторӣ
• Кэшкунии prompt. Prompt-е, ки мисли prompt-и наздик дар ҳамон модел оғоз мешавад, аз кэш хонда мешавад ва қисми кэшшуда бо 25% нархи вуруд ҳисоб карда мешавад. Он майдони дархост талаб намекунад. Кэшизатсозии prompt
• Ҷустуҷӯи веб. Бо web_search: true API дар веб ҷустуҷӯ мекунад ва натиҷаҳоро пеш аз ҷавоб ба модел медиҳад. Дар /v1/chat/completions ва /v1/messages. Он майдони дархост аст ва дар GET /v1/models парчам надорад. Ҷустуҷӯи веб
• Streaming. Бо stream: true ҷавоб ҳангоми навиштани модел ҳамчун рӯйдодҳои фиристодаи сервер меояд. Ҳар модел дар ҳар се endpoint streaming мекунад. Стриминг

Ҳамин далелҳо аз 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 ҷавоб медиҳад: имконияте, ки берун аз сатри он аст, дар ҷавоб иштирок намекунад. Идораи хатогиҳо