Változásnapló
Legutóbbi frissítések és fejlesztések a Shannon API-hoz.
Ez az oldal az API hívójaként megfigyelhető változásokat sorolja fel: új végpontokat, mezőket és modelleket, megváltozott viselkedést és javításokat. A legújabb bejegyzések vannak elöl. Minden bejegyzés tartalmazza a változtatás dátumát.
A Törő változás jelöléssel ellátott bejegyzés megváltoztathatja egy korábban működő kérés eredményét. Az API-nak egy verziója van, a /v1, ezért a változások dátum szerint szerepelnek, nem verziószám szerint.
- Új
A
web_search: trueértékű kérés megnevezi a forrásait: asourcesa/v1/chat/completionsés/v1/messagesvégponton felsorolja a modell által kapott eredményeket, a/v1/chat/completionsvégponton pedig azannotationsjelöli, hol hivatkozik a válasz mindegyikre. Beépített webes keresés
- Új
A
web_search: truea/v1/chat/completionsés/v1/messagesvégponton webes keresést futtat a modell válasza előtt, és az eredményeket számozott forrásokként adja át neki. Az eredményt találó kérés a napi keretedből egy keresést használ el. Ha nem maradt, a kérésre keresés nélkül válaszol a rendszer. Beépített webes keresés
- Javítva
A szerveroldalon megszakadó stream az addig jelentett használat szerint számlázódik. A foglalás többi része visszakerül az egyenlegedre.
- Javítva
A
shannon-coder-1a/v1/responsesvégponton is válaszol, ahogy a másik két végponton. CLI kódoló eszközök - Javítva
A lecserélt API-kulcs azonnal megszűnik működni.
- Új
POST /v1/tokenizeésPOST /v1/messages/count_tokens: ingyenes tokenszámlálás a hosztolt nyílt súlyú modellekhez. Tokenszámlálás - Új
Prompt-gyorsítótárazás a hosztolt nyílt súlyú modelleken. A gyorsítótárazott bemenet a bemeneti ár 25%-án számlázódik, és mindhárom végponton a
usagejelzi:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokenséscache_read_input_tokens. AGET /v1/modelsezekhez a modellekhez megadja apricing.cached_input_per_million_usdéscapabilities.prompt_cachingértékét. Prompt gyorsítványozás - Javítva
Hosztolt nyílt súlyú modellek: a kényszerített
tool_choice(requiredvagy egy megnevezett függvény) eszközhívást eredményez. Funkcióhívás - Javítva
A hosztolt nyílt súlyú modellek elfogadnak olyan
systemüzenetet, amely nem a beszélgetés első üzenete.
- Új
Az API Tor onion szolgáltatásként és I2P-címen is elérhető. Az
api.shannon-ai.comválaszai a két címet azOnion-LocationésX-I2P-Locationfejlécben viszik. Titkosított, Tor és I2P végpontok
- Új
Új modellek:
shannon-3.1ésshannon-3.1-pro, aGET /v1/modelsfelsorolja őket. Modellek és árak - Módosítva
Az a streamelt kérés, amelynek kliense lekapcsolódik, a végéig fut, és beszámít. Korábban a válasz a lekapcsolódásnál megállt.
- Javítva
A
/v1/responseskérései megjelennek a használati naplóban.
- Új
A hosztolt nyílt súlyú modellek alkalmazzák a mintavételi mezőket:
temperature,top_p,seed,stopésmax_tokensa/v1/chat/completionsvégponton;temperature,top_pésstop_sequencesa/v1/messagesvégponton;temperature,top_pésmax_output_tokensa/v1/responsesvégponton. Chat Completions - Új
A használati napló hívásonként és összesítve is USD-ben mutatja a költséget.
- Törő változás
A nem közzétett azonosítót tartalmazó
modelértékre mindhárom végponton400a válasz,invalid_request_errortípussal ésunknown model: <id>üzenettel. Korábban az ilyen kérésre ashannon-1.6-liteválaszolt. Modellek és árak - Törő változás
A
/v1csak API-kulcsot fogad. A weboldal bejelentkezési cookie-ját ott nem olvassa a rendszer. Hitelesítés - Módosítva
Flood protection: fiókonként percenként 120 kérés a három generáló végponton. Korlátok és egyenleg
- Fejlesztve
Ha a modell nem tud válaszolni, a hiba a rögzített
The model backend failed to answer. Please retry.üzenetet hordozza. Az el nem végezhető egyenlegellenőrzésre503a válasz,api_errortípussal. Hibakezelés - Javítva
A sikertelen, nem streamelt kérés visszaadja a foglalását az egyenlegednek.
- Új
A
GET /v1/modelsminden modellhez megadja acapabilities.reasoning_effortértéket. Reasoning effort - Fejlesztve
Hosztolt nyílt súlyú modellek: a választ nem kapó, nem streamelt kérés
504kóddal ésapi_errortípussal ér véget. Az üres eredmény502. Hibakezelés
- Törő változás
A hosztolt nyílt súlyú modellek azt a bemenetet fogadják, amelyet a megnevezett modell fogad. A csak szöveget fogadó azonosítónak küldött képre
400a válasz<id> does not accept image inputüzenettel. A strukturált kimenet nélküli azonosítón aresponse_format400választ kap. AGET /v1/modelsminden azonosítóhoz megadja acapabilities.vision,response_formatésjson_schemaértékét. Képek és fájlok - Javítva
A nem streamelt válaszok tartalmazzák a reasoning-szöveget:
reasoning_contenta/v1/chat/completionsüzenetén, és egythinkingblokk a szöveg előtt a/v1/messagesvégponton. Reasoning effort - Módosítva
A hosztolt nyílt súlyú modellek új árakat kaptak: 1M bemeneti tokenre $0.50-tól és 1M kimeneti tokenre $2.00-tól. Modellek és árak
- Módosítva
A hosztolt nyílt súlyú modelleknek modellenként egy azonosítójuk van, összesen tizenkettő. Modellek és árak
- Új
Strukturált kimenet a
shannon-3,shannon-3-pro,shannon-3.1ésshannon-3.1-promodellen. AGET /v1/modelsezekrecapabilities.json_schema: trueértéket ad. Strukturált kimenetek - Új
A
/v1/responsesatext.formatmezőt (json_objectvagyjson_schema) olvassa a strukturált kimenethez. Responses API - Javítva
A
/v1/responsesvisszaadja a Shannon modellek reasoningját: egyreasoningkimeneti elemet amessageelem előtt, valamint aresponse.reasoning_summary_text.deltaésresponse.reasoning_summary_text.donestreameseményeket. Responses API - Javítva
A válasz
modelmezője minden végponton a közzétett azonosító. A Responses objektum tartalmazza amodelés acreated_atmezőt. - Fejlesztve
A
GET /v1/modelsmegadja az egyes modellek kontextusablakát. Modellek és árak
- Új
A hosztolt nyílt súlyú modellek a
/v1/chat/completionsmellett a/v1/messagesés a/v1/responsesvégponton is válaszolnak, a te rendszerprompt-odat és eszközhívásaidat használva. A/v1/messagesfogadja athinkingmezőt, areasoning_effortpedig kérésmező. Modellek és árak - Fejlesztve
A
/v1hibatörzsei az SDK-alakokat követik: az OpenAI formátumú végpontokon egyerrorobjektumtypeésmessagemezővel, a/v1/messagesvégponton ugyanez az objektum a{"type": "error"}belsejében. Hibakezelés - Új
Keep-alive a nyitott streameken 15 másodpercenként: egy
: pingmegjegyzéssor a/v1/chat/completions, egyevent: pinga/v1/messagesvégponton. Streaming - Módosítva
Az eszközhívás-azonosítók
call_előtaggal kezdődnek a/v1/chat/completionsés/v1/responsesvégponton, éstoolu_előtaggal a/v1/messagesvégponton. Funkcióhívás - Törő változás
/v1/responses: astreamalapértékefalse. Responses API - Új
A
max_completion_tokensamax_tokensmásik neveként elfogadott a/v1/chat/completionsvégponton. Chat Completions - Javítva
A Responses stream
response.completedeseménye tartalmazza azoutputtömböt. Responses API - Új
A
GET /v1/modelselemei tartalmazzák adisplay_name,context_window,max_output_tokens,pricing,capabilitiesésendpointsmezőket. Modellek és árak - Új
Minden válasz tartalmaz
x-request-idfejlécet, és az általad küldött értéket visszaadja. A kérések törzse legfeljebb 32 MiB lehet. - Új
A kulcs visszavonható anélkül, hogy új kulcs készülne. A használati napló lapozható.
- Új
Képek és dokumentumok a kérésekben:
image_urlrészek a/v1/chat/completionsvégponton,image,documentésfileblokkok a/v1/messagesvégponton,input_imagerészek a/v1/responsesvégponton. Képek és fájlok - Új
Új modell:
shannon-3-pro. Modellek és árak
- Új
Új modell:
shannon-3. Modellek és árak - Új
A
/v1/chat/completionsstreamjei a reasoningotdelta.reasoning_contentmezőben viszik. Reasoning effort
- Módosítva
A
max_tokensértéke 1 és 65,536 között marad. A tartományon kívüli értéket a rendszer a legközelebbi határra igazítja, nem utasítja el. Chat Completions
- Új
A
shannon-coder-1hívásokban számít csomagonként a/v1/chat/completionsés/v1/messagesvégponton. Ha egy ablak hívásai elfogytak, a válasz429aShannon Coder call quota reachedüzenettel. CLI kódoló eszközök - Új
A kontextusablaknál nagyobb beszélgetésre
400a válasz,invalid_request_errortípussal éscontext_length_exceededkóddal. A streamen belüli hiba hibaeseményként érkezik, nem szövegként a válaszban. CLI kódoló eszközök
- Új
A
/v1végpontok:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesésGET /v1/models. Ezeket hívják az OpenAI és Anthropic SDK-k, a Claude Code és a Codex CLI. Áttekintés - Új
Eszközhívások a
toolsmezővel a/v1/chat/completionsés/v1/messagesvégponton, strukturált kimenet aresponse_formatmezővel, és asystemstringként vagy szövegblokkokként a/v1/messagesvégponton. Funkcióhívás
- Új
A
shannon-1.6-pro,shannon-2-lite,shannon-2-proésshannon-coder-1modellazonosítók ashannon-1.6-litemellett. Modellek és árak
- Új
Az API első kiadása: chat OpenAI formátumban és Anthropic formátumban, valamint egy Responses végpont, mindegyik
sk-előtagú API-kulccsal hívható. Hitelesítés