Անցնել բովանդակությանը
Փոփոխությունների մատյան

Փոփոխությունների մատյան

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-Location header-ներում։ Գաղտնագրված, 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։ Մոդելներ և գներ

  • Փոփոխված

    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 գործիքներ ծրագրավորման համար

  • Նոր

    /v1 endpoint-ները՝ 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 բանալիով։ Վավերացում