Değişiklik Günlüğü
Shannon API'deki son güncellemeler ve iyileştirmeler.
Bu sayfa, API'yi çağıran biri olarak gözlemleyebileceğiniz değişiklikleri listeler: yeni uç noktalar, alanlar ve modeller, değişen davranışlar ve düzeltmeler. En yeni girdiler önce gelir. Her girdi, değişikliğin yapıldığı tarihi taşır.
Uyumsuz değişiklik olarak işaretlenmiş bir girdi, daha önce çalışan bir isteğin sonucunu değiştirebilir. API'nin tek bir sürümü vardır, /v1; bu yüzden değişiklikler sürüm numarasına göre değil tarihe göre listelenir.
- Yeni
web_search: trueiçeren bir istek kaynaklarını belirtir:/v1/chat/completionsve/v1/messagesüzerindekisourcesmodele verilen sonuçları listeler,/v1/chat/completionsüzerindekiannotationsise yanıtın her birini nerede alıntıladığını işaretler. Yerleşik Web Arama
- Yeni
/v1/chat/completionsve/v1/messagesüzerindeweb_search: true, model yanıtlamadan önce bir web araması yapar ve sonuçları numaralı kaynaklar olarak ona verir. Sonuç bulan bir istek, günlük limitinizden bir arama kullanır. Hiç kalmadıysa istek aramasız yanıtlanır. Yerleşik Web Arama
- Düzeltildi
Sunucu tarafında kesilen bir akış, o ana kadar bildirilen kullanım için faturalandırılır. Ayrılan tutarın geri kalanı bakiyenize döner.
- Düzeltildi
shannon-coder-1, diğer iki uç noktada olduğu gibi/v1/responsesüzerinde de yanıt verir. CLI kodlama araçları - Düzeltildi
Yenilenen bir API anahtarı hemen çalışmayı durdurur.
- Yeni
POST /v1/tokenizevePOST /v1/messages/count_tokens: host edilen açık ağırlıklı modeller için ücretsiz token sayımı. Token sayma - Yeni
Host edilen açık ağırlıklı modellerde istem önbelleğe alma. Önbelleğe alınmış girdi, giriş fiyatının %25'i üzerinden faturalandırılır ve üç uç noktada da
usageiçinde bildirilir:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensvecache_read_input_tokens.GET /v1/modelsbu modeller içinpricing.cached_input_per_million_usdvecapabilities.prompt_cachingbildirir. İstem önbelleğe alma - Düzeltildi
Host edilen açık ağırlıklı modeller: zorunlu bir
tool_choice(requiredveya adı verilmiş bir fonksiyon) bir araç çağrısı üretir. Fonksiyon Çağırma - Düzeltildi
Host edilen açık ağırlıklı modeller, konuşmanın ilk mesajı olmayan bir
systemmesajını kabul eder.
- Yeni
API, bir Tor onion servisi olarak ve bir I2P adresinde erişilebilir.
api.shannon-ai.comyanıtları iki adresiOnion-LocationveX-I2P-Locationbaşlıklarında taşır. Şifreli, Tor & I2P uç noktaları
- Yeni
GET /v1/modelstarafından listelenen yeni modellershannon-3.1veshannon-3.1-pro. Modeller ve fiyatlandırma - Değişti
İstemcisi bağlantıyı kesen akışlı bir istek sonuna kadar çalışır ve sayılır. Öncesinde yanıt bağlantı kesildiğinde duruyordu.
- Düzeltildi
/v1/responsesistekleri kullanım günlüğünde görünür.
- Yeni
Host edilen açık ağırlıklı modeller örnekleme alanlarını uygular:
/v1/chat/completionsüzerindetemperature,top_p,seed,stopvemax_tokens;/v1/messagesüzerindetemperature,top_pvestop_sequences;/v1/responsesüzerindetemperature,top_pvemax_output_tokens. Chat Completions - Yeni
Kullanım günlüğü her çağrı için ve toplam olarak USD cinsinden bir maliyet gösterir.
- Uyumsuz değişiklik
Yayımlanmış bir kimlik olmayan
modeldeğeri, üç uç noktada da400,invalid_request_errortürü veunknown model: <id>mesajıyla yanıtlanır. Öncesinde böyle bir isteğishannon-1.6-liteyanıtlıyordu. Modeller ve fiyatlandırma - Uyumsuz değişiklik
/v1yalnızca bir API anahtarı kabul eder. Web sitesinin oturum çerezi orada okunmaz. Kimlik Doğrulama - Değişti
Flood koruması: üç üretim uç noktasında hesap başına dakikada 120 istek. Limitler ve bakiye
- İyileştirildi
Model yanıt veremediğinde hata,
The model backend failed to answer. Please retry.sabit mesajını taşır. Yapılamayan bir bakiye kontrolü503veapi_errortürüyle yanıtlanır. Hata yönetimi - Düzeltildi
Başarısız olan akışsız bir istek, ayırdığı tutarı bakiyenize geri verir.
- Yeni
GET /v1/modelsher model içincapabilities.reasoning_effortbildirir. Akıl yürütme çabası - İyileştirildi
Host edilen açık ağırlıklı modeller: yanıt alamayan akışsız bir istek
504veapi_errortürüyle biter. Boş sonuç502olur. Hata yönetimi
- Uyumsuz değişiklik
Host edilen açık ağırlıklı modeller, adı geçen modelin kabul ettiği girdiyi kabul eder. Yalnızca metin kabul eden bir kimliğe gönderilen görsel
400ve<id> does not accept image inputile yanıtlanır. Yapılandırılmış çıktısı olmayan bir kimlikteresponse_format400ile yanıtlanır.GET /v1/modelsher kimlik içincapabilities.vision,response_formatvejson_schemabildirir. Görseller ve dosyalar - Düzeltildi
Akışsız yanıtlar akıl yürütme metnini taşır:
/v1/chat/completionsüzerinde mesajınreasoning_contentalanı,/v1/messagesüzerinde metnin önünde birthinkingbloğu. Akıl yürütme çabası - Değişti
Host edilen açık ağırlıklı modellerin yeni fiyatları var: 1M girdi token'ı başına $0.50 ve 1M çıktı token'ı başına $2.00'dan başlayarak. Modeller ve fiyatlandırma
- Değişti
Host edilen açık ağırlıklı modellerin her model için bir kimliği vardır; toplam on iki kimlik. Modeller ve fiyatlandırma
- Yeni
shannon-3,shannon-3-pro,shannon-3.1veshannon-3.1-proüzerinde yapılandırılmış çıktı.GET /v1/modelsbunlar içincapabilities.json_schema: truebildirir. Yapılandırılmış Çıktılar - Yeni
/v1/responses, yapılandırılmış çıktı içintext.formatalanını (json_objectveyajson_schema) okur. Responses API - Düzeltildi
/v1/responses, Shannon modellerinin akıl yürütmesini döndürür:messageöğesinden önce birreasoningçıktı öğesi veresponse.reasoning_summary_text.deltaileresponse.reasoning_summary_text.doneakış olayları. Responses API - Düzeltildi
Bir yanıtın
modelalanı, her uç noktada yayımlanmış kimliktir. Bir Responses nesnesimodelvecreated_attaşır. - İyileştirildi
GET /v1/modelsher modelin bağlam penceresini bildirir. Modeller ve fiyatlandırma
- Yeni
Host edilen açık ağırlıklı modeller
/v1/chat/completionsyanında/v1/messagesve/v1/responsesüzerinde de sistem isteminiz ve araç çağrılarınızla yanıt verir./v1/messagesthinkingalanını alır vereasoning_effortbir istek alanıdır. Modeller ve fiyatlandırma - İyileştirildi
/v1üzerindeki hata gövdeleri SDK biçimlerini izler: OpenAI biçimli uç noktalardatypevemessageiçeren birerrornesnesi,/v1/messagesüzerinde aynı nesne{"type": "error"}içinde. Hata yönetimi - Yeni
Açık akışlarda her 15 saniyede keep-alive:
/v1/chat/completionsüzerinde bir: pingyorum satırı,/v1/messagesüzerinde birevent: ping. Akış - Değişti
Araç çağrısı kimlikleri
/v1/chat/completionsve/v1/responsesüzerindecall_ile,/v1/messagesüzerindetoolu_ile başlar. Fonksiyon Çağırma - Uyumsuz değişiklik
/v1/responses:streamvarsayılan olarakfalsedeğerindedir. Responses API - Yeni
max_completion_tokens,/v1/chat/completionsüzerindemax_tokensiçin başka bir ad olarak kabul edilir. Chat Completions - Düzeltildi
Bir Responses akışının
response.completedolayıoutputdizisini taşır. Responses API - Yeni
GET /v1/modelsgirdileridisplay_name,context_window,max_output_tokens,pricing,capabilitiesveendpointsalanlarını taşır. Modeller ve fiyatlandırma - Yeni
Her yanıt
x-request-idtaşır ve gönderdiğiniz değer geri döndürülür. İstek gövdeleri 32 MiB'a kadar olabilir. - Yeni
Bir anahtar, yenisi verilmeden iptal edilebilir. Kullanım günlüğü sayfalanır.
- Yeni
İsteklerde görseller ve dokümanlar:
/v1/chat/completionsüzerindeimage_urlparçaları,/v1/messagesüzerindeimage,documentvefileblokları,/v1/responsesüzerindeinput_imageparçaları. Görseller ve dosyalar - Yeni
Yeni model
shannon-3-pro. Modeller ve fiyatlandırma
- Yeni
Yeni model
shannon-3. Modeller ve fiyatlandırma - Yeni
/v1/chat/completionsüzerindeki akışlar akıl yürütmeyidelta.reasoning_contentolarak taşır. Akıl yürütme çabası
- Değişti
max_tokens1 ile 65,536 arasında tutulur. Bu aralığın dışındaki bir değer reddedilmez, en yakın uca getirilir. Chat Completions
- Yeni
shannon-coder-1,/v1/chat/completionsve/v1/messagesüzerinde plan başına çağrı olarak sayılır. Bir pencerenin çağrıları tükendiğinde yanıt,Shannon Coder call quota reachedmesajıyla429olur. CLI kodlama araçları - Yeni
Bağlam penceresinden büyük bir konuşma,
400,invalid_request_errortürü vecontext_length_exceededkoduyla yanıtlanır. Bir akışın içindeki hata, yanıtta metin olarak değil hata olayı olarak gelir. CLI kodlama araçları
- Yeni
/v1uç noktaları:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesveGET /v1/models. OpenAI ve Anthropic SDK'larının, Claude Code'un ve Codex CLI'ın çağırdığı uç noktalar bunlardır. Genel Bakış - Yeni
/v1/chat/completionsve/v1/messagesüzerindetoolsile araç çağrıları,response_formatile yapılandırılmış çıktı ve/v1/messagesüzerinde dizge veya metin blokları olaraksystem. Fonksiyon Çağırma
- Yeni
shannon-1.6-liteyanındashannon-1.6-pro,shannon-2-lite,shannon-2-proveshannon-coder-1model kimlikleri. Modeller ve fiyatlandırma
- Yeni
API'nin ilk sürümü: OpenAI biçiminde ve Anthropic biçiminde sohbet ve bir Responses uç noktası; her biri
sk-ile başlayan bir API anahtarıyla çağrılır. Kimlik Doğrulama