Dəyişikliklər jurnalı
Shannon API üçün son yeniliklər və təkmilləşdirmələr.
Bu səhifə API-nin çağıranı kimi müşahidə edə biləcəyiniz dəyişiklikləri siyahıya alır: yeni endpoint-lər, sahələr və modellər, dəyişmiş davranış və düzəlişlər. Ən yeni qeydlər birincidir. Hər qeyd dəyişikliyin edildiyi tarixi daşıyır.
Breaking ilə işarələnmiş qeyd əvvəllər işləyən sorğunun nəticəsini dəyişə bilər. API-nin bir versiyası var, /v1, buna görə dəyişikliklər versiya nömrəsi ilə yox, tarixlə siyahıya alınır.
- Yeni
web_search: trueolan sorğu mənbələrini adlandırır:/v1/chat/completionsvə/v1/messages-dəsourcesmodelə verilən nəticələri siyahılayır,/v1/chat/completions-da isəannotationscavabın hər birinə harada istinad etdiyini göstərir. Veb axtarışı
- Yeni
/v1/chat/completionsvə/v1/messagesüzərindəweb_search: truemodel cavab verməzdən əvvəl veb axtarışı aparır və nəticələri nömrələnmiş mənbələr kimi ona verir. Nəticə tapan sorğu gündəlik limitinizdən bir axtarış istifadə edir. Qalmadıqda sorğuya axtarışsız cavab verilir. Veb axtarışı
- Düzəldilib
Server tərəfdən kəsilən axın həmin ana qədər bildirilən istifadəyə görə hesablanır. Rezervasiyanın qalan hissəsi balansınıza qayıdır.
- Düzəldilib
shannon-coder-1digər iki endpoint-də olduğu kimi/v1/responsesüzərində də cavab verir. CLI kodlaşdırma alətləri - Düzəldilib
Yenilənmiş API açarı dərhal işləməyi dayandırır.
- Yeni
POST /v1/tokenizevəPOST /v1/messages/count_tokens: host edilmiş açıq çəkili modellər üçün pulsuz token sayı. Tokenlərin sayılması - Yeni
Host edilmiş açıq çəkili modellərdə prompt keşləmə. Keşlənmiş giriş giriş qiymətinin 25%-i ilə hesablanır və hər üç endpoint-də
usagedaxilində bildirilir:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensvəcache_read_input_tokens.GET /v1/modelsbu modellər üçünpricing.cached_input_per_million_usdvəcapabilities.prompt_cachingbildirir. Prompt keşləmə - Düzəldilib
Host edilmiş açıq çəkili modellər: məcburi
tool_choice(requiredvə ya adı verilmiş funksiya) alət çağırışı verir. Funksiya çağırışı - Düzəldilib
Host edilmiş açıq çəkili modellər söhbətin ilk mesajı olmayan
systemmesajını qəbul edir.
- Yeni
API Tor onion xidməti kimi və I2P ünvanında əlçatandır.
api.shannon-ai.comcavabları iki ünvanıOnion-LocationvəX-I2P-Locationbaşlıqlarında daşıyır. Şifrələnmiş, Tor & I2P endpoint-ləri
- Yeni
GET /v1/modelstərəfindən siyahıya alınan yeni modellərshannon-3.1vəshannon-3.1-pro. Modellər və qiymətlər - Dəyişdirilib
Klienti bağlantını kəsən axınlı sorğu sonuna qədər işləyir və sayılır. Əvvəllər cavab bağlantı kəsildikdə dayanırdı.
- Düzəldilib
/v1/responsessorğuları istifadə jurnalında görünür.
- Yeni
Host edilmiş açıq çəkili modellər seçmə sahələrini tətbiq edir:
/v1/chat/completionsüzərindətemperature,top_p,seed,stopvəmax_tokens;/v1/messagesüzərindətemperature,top_pvəstop_sequences;/v1/responsesüzərindətemperature,top_pvəmax_output_tokens. Chat Completions - Yeni
İstifadə jurnalı hər çağırış üçün və yekun olaraq USD ilə xərc göstərir.
- Uyğunsuzluq yaradan dəyişiklik
Dərc olunmuş id olmayan
modeldəyərinə hər üç endpoint-də400,invalid_request_errortipi vəunknown model: <id>mesajı ilə cavab verilir. Əvvəllər belə sorğuyashannon-1.6-litecavab verirdi. Modellər və qiymətlər - Uyğunsuzluq yaradan dəyişiklik
/v1yalnız API açarını qəbul edir. Vebsaytın daxil olma cookie-si orada oxunmur. Doğrulama - Dəyişdirilib
Flood protection: üç generasiya endpoint-ində hesab başına dəqiqədə 120 sorğu. Limitlər və balans
- Təkmilləşdirilib
Model cavab verə bilmədikdə xəta
The model backend failed to answer. Please retry.sabit mesajını daşıyır. Aparıla bilməyən balans yoxlamasına503vəapi_errortipi ilə cavab verilir. Xəta idarəetməsi - Düzəldilib
Uğursuz olan axınsız sorğu rezervasiyasını balansınıza qaytarır.
- Yeni
GET /v1/modelshər model üçüncapabilities.reasoning_effortbildirir. Reasoning effort - Təkmilləşdirilib
Host edilmiş açıq çəkili modellər: cavab almayan axınsız sorğu
504vəapi_errortipi ilə bitir. Boş nəticə502-dir. Xəta idarəetməsi
- Uyğunsuzluq yaradan dəyişiklik
Host edilmiş açıq çəkili modellər adı çəkilən modelin qəbul etdiyi girişi qəbul edir. Yalnız mətn qəbul edən id-yə göndərilən şəklə
400və<id> does not accept image inputilə cavab verilir. Strukturlaşdırılmış çıxışı olmayan id-dəresponse_format400ilə cavablanır.GET /v1/modelshər id üçüncapabilities.vision,response_formatvəjson_schemabildirir. Təsvirlər və fayllar - Düzəldilib
Axınsız cavablar reasoning mətnini daşıyır:
/v1/chat/completionsmesajındareasoning_contentvə/v1/messagesüzərində mətndən əvvəlthinkingbloku. Reasoning effort - Dəyişdirilib
Host edilmiş açıq çəkili modellərin yeni qiymətləri var: 1M giriş tokeni üçün $0.50-dən və 1M çıxış tokeni üçün $2.00-dan başlayaraq. Modellər və qiymətlər
- Dəyişdirilib
Host edilmiş açıq çəkili modellərin hər modelə bir id-si var, cəmi on iki id. Modellər və qiymətlər
- Yeni
shannon-3,shannon-3-pro,shannon-3.1vəshannon-3.1-proüzərində strukturlaşdırılmış çıxış.GET /v1/modelsonlar üçüncapabilities.json_schema: truebildirir. Strukturlaşdırılmış çıxışlar - Yeni
/v1/responsesstrukturlaşdırılmış çıxış üçüntext.format(json_objectvə yajson_schema) sahəsini oxuyur. Responses API - Düzəldilib
/v1/responsesShannon modellərinin reasoning-ini qaytarır:messageelementindən əvvəlreasoningoutput elementi vəresponse.reasoning_summary_text.deltailəresponse.reasoning_summary_text.doneaxın hadisələri. Responses API - Düzəldilib
Cavabın
modelsahəsi hər endpoint-də dərc olunmuş id-dir. Responses obyektimodelvəcreated_atdaşıyır. - Təkmilləşdirilib
GET /v1/modelshər modelin kontekst pəncərəsini bildirir. Modellər və qiymətlər
- Yeni
Host edilmiş açıq çəkili modellər
/v1/chat/completionsilə yanaşı/v1/messagesvə/v1/responsesüzərində də system promptunuz və alət çağırışları ilə cavab verir./v1/messagesthinkingqəbul edir,reasoning_effortisə sorğu sahəsidir. Modellər və qiymətlər - Təkmilləşdirilib
/v1üzərindəki xəta gövdələri SDK formalarına uyğundur: OpenAI formatlı endpoint-lərdətypevəmessageiləerrorobyekti,/v1/messagesüzərində isə eyni obyekt{"type": "error"}daxilində. Xəta idarəetməsi - Yeni
Açıq axınlarda hər 15 saniyədən bir keep-alive:
/v1/chat/completionsüzərində: pingşərh sətri,/v1/messagesüzərindəevent: ping. Axın - Dəyişdirilib
Alət çağırışı id-ləri
/v1/chat/completionsvə/v1/responsesüzərindəcall_ilə,/v1/messagesüzərində isətoolu_ilə başlayır. Funksiya çağırışı - Uyğunsuzluq yaradan dəyişiklik
/v1/responses:streamdefolt olaraqfalse-dur. Responses API - Yeni
max_completion_tokens/v1/chat/completionsüzərindəmax_tokensüçün başqa ad kimi qəbul edilir. Chat Completions - Düzəldilib
Responses axınının
response.completedhadisəsioutputmassivini daşıyır. Responses API - Yeni
GET /v1/modelselementləridisplay_name,context_window,max_output_tokens,pricing,capabilitiesvəendpointsdaşıyır. Modellər və qiymətlər - Yeni
Hər cavab
x-request-iddaşıyır və göndərdiyiniz dəyər geri qaytarılır. Sorğu gövdələri 32 MiB-a qədər ola bilər. - Yeni
Açarı yenisi verilmədən ləğv etmək olar. İstifadə jurnalı səhifələnir.
- Yeni
Sorğularda şəkillər və sənədlər:
/v1/chat/completionsüzərindəimage_urlhissələri,/v1/messagesüzərindəimage,documentvəfileblokları,/v1/responsesüzərindəinput_imagehissələri. Təsvirlər və fayllar - Yeni
Yeni model
shannon-3-pro. Modellər və qiymətlər
- Yeni
Yeni model
shannon-3. Modellər və qiymətlər - Yeni
/v1/chat/completionsüzərindəki axınlar reasoning-idelta.reasoning_contentkimi daşıyır. Reasoning effort
- Dəyişdirilib
max_tokens1 ilə 65,536 aralığında saxlanılır. Bu aralıqdan kənar dəyər rədd edilmir, ən yaxın ucuna gətirilir. Chat Completions
- Yeni
shannon-coder-1/v1/chat/completionsvə/v1/messagesüzərində plan üzrə çağırışlarla sayılır. Pəncərənin çağırışları bitdikdə cavabShannon Coder call quota reachedmesajı ilə429olur. CLI kodlaşdırma alətləri - Yeni
Kontekst pəncərəsindən böyük söhbətə
400,invalid_request_errortipi vəcontext_length_exceededkodu ilə cavab verilir. Axının içindəki xəta cavabda mətn kimi yox, xəta hadisəsi kimi gəlir. CLI kodlaşdırma alətləri
- Yeni
/v1endpoint-ləri:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesvəGET /v1/models. Bunlar OpenAI və Anthropic SDK-larının, Claude Code və Codex CLI-nin çağırdığı endpoint-lərdir. Ümumi baxış - Yeni
/v1/chat/completionsvə/v1/messagesüzərindətoolsilə alət çağırışları,response_formatilə strukturlaşdırılmış çıxış və/v1/messagesüzərində sətir və ya mətn blokları kimisystem. Funksiya çağırışı
- Yeni
shannon-1.6-liteilə yanaşıshannon-1.6-pro,shannon-2-lite,shannon-2-provəshannon-coder-1model id-ləri. Modellər və qiymətlər
- Yeni
API-nin ilk buraxılışı: OpenAI formatında və Anthropic formatında çat və Responses endpoint-i, hər biri
sk-ilə başlayan API açarı ilə çağırılır. Doğrulama