Հնարավորություններ
Ինչ կարող է անել յուրաքանչյուր մոդել API-ի միջոցով՝ մոդել առ մոդել. գործիքներ, պատկերի մուտք, reasoning, JSON արդյունք, prompt caching, վեբ որոնում և streaming։
Յուրաքանչյուր մոդելի հասանելի է նույն երեք endpoint-ներով՝ նույն բանալիով։ Երկու աղյուսակները ցույց են տալիս, թե որտեղ են մոդելները տարբերվում։ Գծիկը նշանակում է, որ մոդելը պատասխանում է առանց այդ հնարավորության։
Shannon մոդելներ
| Մոդել | Գործիքներ | Պատկերներ | Reasoning | Effort | JSON օբյեկտ | JSON schema | Caching | Որոնում | 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։
| Մոդել | Գործիքներ | Պատկերներ | Reasoning | Effort | JSON օբյեկտ | JSON schema | Caching | Որոնում | 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)) 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
}
}
] | Սյուն | 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_cachinghosted 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 կարգավիճակով. իր տողից դուրս հնարավորությունը պատասխանին մասնակցություն չի ունենում։ Սխալների մշակում