Փոփոխությունների մատյան
Shannon API-ի վերջին թարմացումները և բարելավումները։
Այս էջը թվարկում է փոփոխությունները, որոնք դուք կարող եք նկատել որպես API-ի կանչող. նոր endpoint-ներ, դաշտեր և մոդելներ, փոփոխված վարքագիծ և ուղղումներ։ Ամենաթարմ գրառումները գալիս են առաջինը։ Յուրաքանչյուր գրառում կրում է փոփոխության կատարման ամսաթիվը։
Խզող նշված գրառումը կարող է փոխել նախկինում աշխատած հարցման արդյունքը։ API-ն ունի մեկ տարբերակ՝ /v1, ուստի փոփոխությունները թվարկվում են ըստ ամսաթվի, ոչ թե տարբերակի համարի։
- Նոր
web_search: trueունեցող հարցումը անվանում է իր աղբյուրները./v1/chat/completions-ում և/v1/messages-ումsources-ը թվարկում է մոդելին տրված արդյունքները, իսկ/v1/chat/completions-ումannotations-ը նշում է, թե որտեղ է պատասխանը մեջբերում դրանցից յուրաքանչյուրը։ Ներկառուցված վեբ որոնում
- Նոր
/v1/chat/completions-ում և/v1/messages-ումweb_search: true-ը մոդելի պատասխանից առաջ կատարում է վեբ որոնում և արդյունքները նրան տալիս է որպես համարակալված աղբյուրներ։ Արդյունք գտած հարցումը ծախսում է ձեր օրական քվոտայի մեկ որոնում։ Եթե այն չի մնացել, հարցմանը պատասխանվում է առանց որոնման։ Ներկառուցված վեբ որոնում
- Ուղղված
Սերվերի կողմից կտրված հոսքի համար գանձվում է մինչև այդ պահը հաշվված usage-ը։ Վերապահման մնացորդը վերադառնում է ձեր մնացորդին։
- Ուղղված
shannon-coder-1-ը պատասխանում է/v1/responses-ում այնպես, ինչպես մյուս երկու endpoint-ներում։ CLI գործիքներ ծրագրավորման համար - Ուղղված
Փոխարինված API բանալին դադարում է աշխատել անմիջապես։
- Նոր
POST /v1/tokenizeևPOST /v1/messages/count_tokens. թոքենների անվճար հաշվարկ hosted open-weight մոդելների համար։ Թոքենների հաշվարկ - Նոր
Prompt caching hosted open-weight մոդելների վրա։ Cache-ված մուտքը հաշվարկվում է մուտքի գնի 25%-ով և երեք endpoint-ներում էլ նշվում է
usage-ում՝prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensևcache_read_input_tokens։GET /v1/models-ը այս մոդելների համար ցույց է տալիսpricing.cached_input_per_million_usdևcapabilities.prompt_caching։ Հարցման քեշավորում - Ուղղված
Hosted open-weight մոդելներ. հարկադիր
tool_choice-ը (requiredկամ անվանված ֆունկցիա) տալիս է գործիքի կանչ։ Ֆունկցիայի կանչ - Ուղղված
Hosted open-weight մոդելներն ընդունում են
systemհաղորդագրություն, որը զրույցի առաջին հաղորդագրությունը չէ։
- Նոր
API-ն հասանելի է որպես Tor onion service և I2P հասցեով։
api.shannon-ai.com-ի պատասխանները երկու հասցեները կրում ենOnion-LocationևX-I2P-Locationheader-ներում։ Գաղտնագրված, Tor և I2P endpoint-ներ
- Նոր
Նոր մոդելներ՝
shannon-3.1ևshannon-3.1-pro, որոնք թվարկում էGET /v1/models-ը։ Մոդելներ և գներ - Փոփոխված
Streaming հարցումը, որի կլիենտը անջատվում է, աշխատում է մինչև վերջ և հաշվվում է։ Նախկինում պատասխանը կանգ էր առնում անջատման պահին։
- Ուղղված
/v1/responses-ի հարցումները երևում են օգտագործման մատյանում։
- Նոր
Hosted open-weight մոդելները կիրառում են sampling դաշտերը.
temperature,top_p,seed,stopևmax_tokens/v1/chat/completions-ում.temperature,top_pևstop_sequences/v1/messages-ում.temperature,top_pևmax_output_tokens/v1/responses-ում։ Chat Completions - Նոր
Օգտագործման մատյանը ցույց է տալիս արժեքը USD-ով յուրաքանչյուր կանչի համար և որպես ընդհանուր գումար։
- Խզող
modelարժեքին, որը հրապարակված id չէ, երեք endpoint-ներում էլ պատասխանվում է400-ով,invalid_request_errorտեսակով ևunknown model: <id>հաղորդագրությամբ։ Նախկինում այդպիսի հարցմանը պատասխանում էրshannon-1.6-lite-ը։ Մոդելներ և գներ - Խզող
/v1-ն ընդունում է միայն API բանալի։ Կայքի մուտքի cookie-ն այնտեղ չի կարդացվում։ Վավերացում - Փոփոխված
Flood-պաշտպանություն. 120 հարցում րոպեում մեկ հաշվի համար երեք գեներացման endpoint-ներում։ Սահմանաչափեր և մնացորդ
- Բարելավված
Երբ մոդելը չի կարող պատասխանել, սխալը կրում է ֆիքսված հաղորդագրությունը՝
The model backend failed to answer. Please retry.Մնացորդի ստուգումը, որը հնարավոր չէ կատարել, ստանում է503պատասխան ևapi_errorտեսակ։ Սխալների մշակում - Ուղղված
Ձախողվող ոչ-streaming հարցումը վերադարձնում է իր վերապահումը ձեր մնացորդին։
- Նոր
GET /v1/models-ը յուրաքանչյուր մոդելի համար ցույց է տալիսcapabilities.reasoning_effort։ Reasoning effort - Բարելավված
Hosted open-weight մոդելներ. ոչ-streaming հարցումը, որն ընդհանրապես պատասխան չի ստանում, ավարտվում է
504-ով ևapi_errorտեսակով։ Դատարկ արդյունքը502է։ Սխալների մշակում
- Խզող
Hosted open-weight մոդելներն ընդունում են այն մուտքը, որն ընդունում է նշված մոդելը։ Միայն տեքստային id-ին ուղարկված պատկերին պատասխանվում է
400-ով և<id> does not accept image input։ Կառուցվածքային արդյունք չունեցող id-ի վրաresponse_format-ին պատասխանվում է400-ով։GET /v1/models-ը յուրաքանչյուր id-ի համար ցույց է տալիսcapabilities.vision,response_formatևjson_schema։ Պատկերներ և ֆայլեր - Ուղղված
Ոչ-streaming պատասխանները կրում են reasoning տեքստը.
reasoning_content/v1/chat/completions-ի հաղորդագրության վրա, ևthinkingբլոկ տեքստից առաջ/v1/messages-ում։ Reasoning effort - Փոփոխված
Hosted open-weight մոդելներն ունեն նոր գներ՝ սկսած $0.50-ից 1M մուտքային թոքենի համար և $2.00-ից 1M ելքային թոքենի համար։ Մոդելներ և գներ
- Փոփոխված
Hosted open-weight մոդելներն ունեն մեկ id յուրաքանչյուր մոդելի համար, ընդամենը տասներկու id։ Մոդելներ և գներ
- Նոր
Կառուցվածքային արդյունք
shannon-3,shannon-3-pro,shannon-3.1ևshannon-3.1-proմոդելներում։GET /v1/models-ը դրանց համար ցույց է տալիսcapabilities.json_schema: true։ Կառուցվածքային արդյունքներ - Նոր
/v1/responses-ը կառուցվածքային արդյունքի համար կարդում էtext.format(json_objectկամjson_schema)։ Responses API - Ուղղված
/v1/responses-ը վերադարձնում է Shannon մոդելների reasoning-ը.reasoningելքային տարրmessageտարրից առաջ, և հոսքիresponse.reasoning_summary_text.deltaուresponse.reasoning_summary_text.doneիրադարձությունները։ Responses API - Ուղղված
Պատասխանի
modelդաշտը յուրաքանչյուր endpoint-ում հրապարակված id-ն է։ Responses օբյեկտը կրում էmodelևcreated_at։ - Բարելավված
GET /v1/models-ը ցույց է տալիս յուրաքանչյուր մոդելի համատեքստի պատուհանը։ Մոդելներ և գներ
- Նոր
Hosted open-weight մոդելները պատասխանում են
/v1/messages-ում և/v1/responses-ում, ինչպես նաև/v1/chat/completions-ում՝ ձեր system prompt-ով և գործիքների կանչերով։/v1/messages-ն ընդունում էthinking, իսկreasoning_effort-ը հարցման դաշտ է։ Մոդելներ և գներ - Բարելավված
/v1-ի սխալի մարմինները հետևում են SDK-ների ձևերին. OpenAI ձևաչափի endpoint-ներում՝errorօբյեկտtype-ով ևmessage-ով, իսկ/v1/messages-ում՝ նույն օբյեկտը{"type": "error"}-ի ներսում։ Սխալների մշակում - Նոր
Keep-alive բաց հոսքերում ամեն 15 վայրկյանը մեկ.
: pingմեկնաբանության տող/v1/chat/completions-ում,event: ping/v1/messages-ում։ Ստրիմինգ - Փոփոխված
Գործիքի կանչերի id-ները սկսվում են
call_-ով/v1/chat/completions-ում և/v1/responses-ում, ևtoolu_-ով՝/v1/messages-ում։ Ֆունկցիայի կանչ - Խզող
/v1/responses.stream-ի լռելյայն արժեքըfalseէ։ Responses API - Նոր
max_completion_tokens-ը ընդունվում է որպեսmax_tokens-ի այլ անուն/v1/chat/completions-ում։ Chat Completions - Ուղղված
Responses հոսքի
response.completedիրադարձությունը կրում էoutputզանգվածը։ Responses API - Նոր
GET /v1/models-ի գրառումները կրում ենdisplay_name,context_window,max_output_tokens,pricing,capabilitiesևendpoints։ Մոդելներ և գներ - Նոր
Յուրաքանչյուր պատասխան կրում է
x-request-id, և ձեր ուղարկած արժեքը վերադարձվում է։ Հարցման մարմինները կարող են լինել մինչև 32 MiB։ - Նոր
Բանալին կարելի է չեղարկել՝ առանց նորի տրամադրման։ Օգտագործման մատյանը բաժանված է էջերի։
- Նոր
Պատկերներ և փաստաթղթեր հարցումներում.
image_urlմասեր/v1/chat/completions-ում,image,documentևfileբլոկներ/v1/messages-ում,input_imageմասեր/v1/responses-ում։ Պատկերներ և ֆայլեր - Նոր
Նոր մոդել՝
shannon-3-pro։ Մոդելներ և գներ
- Նոր
Նոր մոդել՝
shannon-3։ Մոդելներ և գներ - Նոր
/v1/chat/completions-ի հոսքերը reasoning-ը տալիս են որպեսdelta.reasoning_content։ Reasoning effort
- Փոփոխված
max_tokens-ը պահվում է 1-ից 65,536 սահմաններում։ Այդ միջակայքից դուրս արժեքը բերվում է մոտակա ծայրին, չի մերժվում։ Chat Completions
- Նոր
shannon-coder-1-ը/v1/chat/completions-ում և/v1/messages-ում հաշվվում է ըստ պլանի կանչերի։ Երբ պատուհանի կանչերը սպառվում են, պատասխանը429է՝Shannon Coder call quota reachedհաղորդագրությամբ։ CLI գործիքներ ծրագրավորման համար - Նոր
Համատեքստի պատուհանից մեծ զրույցին պատասխանվում է
400-ով,invalid_request_errorտեսակով ևcontext_length_exceededկոդով։ Հոսքի ներսում սխալը գալիս է որպես error իրադարձություն, ոչ թե որպես տեքստ պատասխանի մեջ։ CLI գործիքներ ծրագրավորման համար
- Նոր
/v1endpoint-ները՝POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesևGET /v1/models։ Սրանք այն endpoint-ներն են, որոնք կանչում են OpenAI և Anthropic SDK-ները, Claude Code-ը և Codex CLI-ը։ Ընդհանուր ակնարկ - Նոր
Գործիքների կանչեր
tools-ով/v1/chat/completions-ում և/v1/messages-ում, կառուցվածքային արդյունքresponse_format-ով, ևsystem՝ որպես տող կամ տեքստային բլոկներ/v1/messages-ում։ Ֆունկցիայի կանչ
- Նոր
Մոդելների id-ներ՝
shannon-1.6-pro,shannon-2-lite,shannon-2-proևshannon-coder-1՝shannon-1.6-lite-ի կողքին։ Մոդելներ և գներ
- Նոր
API-ի առաջին թողարկումը. չատ OpenAI ձևաչափով և Anthropic ձևաչափով, ինչպես նաև Responses endpoint, որոնցից յուրաքանչյուրը կանչվում է
sk--ով սկսվող API բանալիով։ Վավերացում