Անցնել բովանդակությանը
Հնարավորություններ

Հնարավորություններ

Ինչ կարող է անել յուրաքանչյուր մոդել API-ի միջոցով՝ մոդել առ մոդել. գործիքներ, պատկերի մուտք, reasoning, JSON արդյունք, prompt caching, վեբ որոնում և streaming։

Յուրաքանչյուր մոդելի հասանելի է նույն երեք endpoint-ներով՝ նույն բանալիով։ Երկու աղյուսակները ցույց են տալիս, թե որտեղ են մոդելները տարբերվում։ Գծիկը նշանակում է, որ մոդելը պատասխանում է առանց այդ հնարավորության։

Shannon մոդելներ

Մոդել ԳործիքներՊատկերներReasoningEffortJSON օբյեկտJSON schemaCachingՈրոնումStreaming
shannon-1.6-lite ԱյոԱյո——ԱյոԱյո—ԱյոԱյո
shannon-1.6-pro ԱյոԱյոԱյո—ԱյոԱյո—ԱյոԱյո
shannon-2-lite Այո—Այո—ԱյոԱյո—ԱյոԱյո
shannon-2-pro Այո—Այո—ԱյոԱյո—ԱյոԱյո
shannon-3 ԱյոԱյոԱյո—ԱյոԱյո—ԱյոԱյո
shannon-3-pro ԱյոԱյոԱյո—ԱյոԱյո—ԱյոԱյո
shannon-3.1 ԱյոԱյոԱյո—ԱյոԱյո—ԱյոԱյո
shannon-3.1-pro ԱյոԱյոԱյո—ԱյոԱյո—ԱյոԱյո
shannon-3.5 Այո———ԱյոԱյո——Այո
shannon-coder-1 Այո—Այո—ԱյոԱյո——Այո

Hosted open-weight մոդելներ

Hosted մոդելի id-ն նրա անվան և տարբերակի միացումն է գծիկով, օրինակ՝ DeepSeek-V4-Pro-0813-3BIT-REAP։

Մոդել ԳործիքներՊատկերներReasoningEffortJSON օբյեկտJSON schemaCachingՈրոնումStreaming
DeepSeek-V4-Pro-0813 3BIT-REAP Այո—ԱյոԱյոԱյոԱյոԱյո—Այո
GLM-5.2 3BIT-REAP Այո—ԱյոԱյոԱյոԱյոԱյո—Այո
Kimi-K3 3BIT-REAP ԱյոԱյոԱյոԱյոԱյոԱյոԱյո—Այո
Nemotron3Ultra 3BIT-REAP Այո—ԱյոԱյոԱյոԱյոԱյո—Այո
MiniMax-M3 3BIT-REAP ԱյոԱյոԱյոԱյոԱյոԱյոԱյո—Այո
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Այո—ԱյոԱյոԱյոԱյոԱյո—Այո
Kimi-K2.6 W4A16-AUTOROUND-REAP ԱյոԱյոԱյոԱյոԱյոԱյոԱյո—Այո
Laguna-S-2.1 W4A16-AUTOROUND-REAP Այո—ԱյոԱյո——Այո—Այո
inkling W4A16-AUTOROUND-REAP ԱյոԱյոԱյոԱյոԱյո—Այո—Այո
MiMo-V2.5-Pro W8A16 Այո—ԱյոԱյոԱյոԱյոԱյո—Այո
MiMo-V2.5 W8A16 ԱյոԱյոԱյոԱյոԱյոԱյոԱյո—Այո
Hy3 W8A16 Այո—ԱյոԱյոԱյոԱյոԱյո—Այո

Ինչ է նշանակում յուրաքանչյուր սյուն

  • Գործիքներ. Դուք նկարագրում եք ֆունկցիաները tools-ում, մոդելը պատասխանում է այն կանչերով, որոնք ցանկանում է կատարել, և ձեր կոդը կատարում է դրանք։ Յուրաքանչյուր մոդել ընդունում է գործիքներ։ Հարկադիր tool_choice-ը կիրառում են hosted open-weight մոդելները։ Ֆունկցիայի կանչ
  • Պատկերի մուտք. Մոդելը կարդում է օգտատիրոջ հաղորդագրության մեջ ուղարկված պատկերները՝ որպես data URL կամ հասցե։ shannon-2-lite-ը և shannon-2-pro-ն պատկերները կարդում են նաև այն հարցումներում, որոնք ուղարկում են tools կամ response_format։ Shannon 3 ընտանիքը կարդում է նաև փաստաթղթեր։ Պատկերներ և ֆայլեր
  • Reasoning. Պատասխանը կարող է պարունակել մոդելի reasoning տեքստը պատասխանի կողքին՝ առանձին դաշտում։ Reasoning effort
  • Reasoning effort. Հարցման դաշտը սահմանում է, թե որքան խորն է մոդելը տրամաբանում՝ off, low, medium կամ high։ Shannon մոդելներն իրենք են որոշում խորությունը։ Reasoning 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-ում։ Կառուցվածքային արդյունքներ
  • Prompt caching. Prompt-ը, որը սկսվում է նույն մոդելի վրա վերջերս ուղարկվածի պես, կարդացվում է cache-ից, և cache-ված մասը հաշվարկվում է մուտքի գնի 25%-ով։ Հարցման դաշտ պետք չէ։ Հարցման քեշավորում
  • Վեբ որոնում. web_search: true-ով API-ն որոնում է համացանցում և արդյունքները տալիս է մոդելին՝ նախքան պատասխանելը։ /v1/chat/completions-ում և /v1/messages-ում։ Սա հարցման դաշտ է և GET /v1/models-ում flag չունի։ Ներկառուցված վեբ որոնում
  • Streaming. stream: true-ով պատասխանը գալիս է որպես server-sent events, մինչ մոդելը գրում է։ Յուրաքանչյուր մոդել աշխատում է streaming-ով երեք 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))

data-ի երկու գրառման id-ն և capabilities-ը.

200 JSON
[
  {
    "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
    }
  }
]
Սյուն Flag-ը capabilities-ում
Գործիքներ tools
Պատկերի մուտք vision
Reasoning reasoning
Reasoning effort reasoning_effort
JSON օբյեկտ response_format
JSON schema json_schema
Prompt caching prompt_caching
Վեբ որոնում Flag չէ. հարցման web_search դաշտն է։
Streaming streaming
  • response_format և prompt_caching hosted open-weight գրառումների flag-երն են։ Shannon գրառումը JSON արդյունքը նշում է միայն json_schema-ով, որը նշանակում է JSON-ի երկու ռեժիմները։
  • vision-ը true է shannon-2-lite-ի և shannon-2-pro-ի համար. նրանք կարդում են պատկերները նաև այն հարցումներում, որոնք ուղարկում են tools կամ response_format։

Մոդելի տողից դուրս

Hosted open-weight մոդելը մերժում է պատկերը կամ JSON ռեժիմը, որը դուրս է իր տողից։ Մերժումը գալիս է մինչև ձեր մնացորդից որևէ բան հանելը.

Կարգավիճակ Տեսակ Հաղորդագրություն Երբ
400 invalid_request_error <id> does not accept image input Պատկեր է ուղարկվել hosted open-weight մոդելին, որը պատկերի մուտք չունի։
400 invalid_request_error <id> does not accept response_format JSON արդյունք է պահանջվել hosted open-weight մոդելից, որը JSON ոչ մի ռեժիմ չունի։
400 invalid_request_error <id> does not accept response_format json_schema; use json_object Schema է ուղարկվել hosted open-weight մոդելին, որն ունի միայն JSON object ռեժիմ։

Shannon մոդելը նման հարցմանը պատասխանում է 200 կարգավիճակով. իր տողից դուրս հնարավորությունը պատասխանին մասնակցություն չի ունենում։ Սխալների մշակում