İçeriğe geç
Yetenekler

Yetenekler

Her modelin API üzerinden neler yapabildiği, model model: araçlar, görsel girdisi, akıl yürütme, JSON çıktısı, istem önbelleğe alma, web araması ve streaming.

Her modele aynı üç uç nokta üzerinden aynı anahtarla ulaşılır. İki tablo, modellerin nerede farklılaştığını gösterir. Tire, modelin o yetenek olmadan yanıt verdiği anlamına gelir.

Shannon modelleri

Model AraçlarGörsellerAkıl yürütmeÇabaJSON nesnesiJSON şemasıÖnbellekAramaStreaming
shannon-1.6-lite EvetEvet——EvetEvet—EvetEvet
shannon-1.6-pro EvetEvetEvet—EvetEvet—EvetEvet
shannon-2-lite Evet—Evet—EvetEvet—EvetEvet
shannon-2-pro Evet—Evet—EvetEvet—EvetEvet
shannon-3 EvetEvetEvet—EvetEvet—EvetEvet
shannon-3-pro EvetEvetEvet—EvetEvet—EvetEvet
shannon-3.1 EvetEvetEvet—EvetEvet—EvetEvet
shannon-3.1-pro EvetEvetEvet—EvetEvet—EvetEvet
shannon-3.5 Evet———EvetEvet——Evet
shannon-coder-1 Evet—Evet—EvetEvet——Evet

Host edilen açık ağırlıklı modeller

Host edilen bir modelin kimliği, adı ile varyantının tireyle birleştirilmesidir; örneğin DeepSeek-V4-Pro-0813-3BIT-REAP.

Model AraçlarGörsellerAkıl yürütmeÇabaJSON nesnesiJSON şemasıÖnbellekAramaStreaming
DeepSeek-V4-Pro-0813 3BIT-REAP Evet—EvetEvetEvetEvetEvet—Evet
GLM-5.2 3BIT-REAP Evet—EvetEvetEvetEvetEvet—Evet
Kimi-K3 3BIT-REAP EvetEvetEvetEvetEvetEvetEvet—Evet
Nemotron3Ultra 3BIT-REAP Evet—EvetEvetEvetEvetEvet—Evet
MiniMax-M3 3BIT-REAP EvetEvetEvetEvetEvetEvetEvet—Evet
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Evet—EvetEvetEvetEvetEvet—Evet
Kimi-K2.6 W4A16-AUTOROUND-REAP EvetEvetEvetEvetEvetEvetEvet—Evet
Laguna-S-2.1 W4A16-AUTOROUND-REAP Evet—EvetEvet——Evet—Evet
inkling W4A16-AUTOROUND-REAP EvetEvetEvetEvetEvet—Evet—Evet
MiMo-V2.5-Pro W8A16 Evet—EvetEvetEvetEvetEvet—Evet
MiMo-V2.5 W8A16 EvetEvetEvetEvetEvetEvetEvet—Evet
Hy3 W8A16 Evet—EvetEvetEvetEvetEvet—Evet

Her sütun ne anlama gelir

  • Araçlar. Fonksiyonları tools içinde tanımlarsınız, model yapılmasını istediği çağrılarla yanıt verir ve kodunuz onları çalıştırır. Her model araçları kabul eder. Zorunlu bir tool_choice, host edilen açık ağırlıklı modeller tarafından uygulanır. Fonksiyon Çağırma
  • Görsel girdisi. Model, bir kullanıcı mesajı içinde data URL veya adres olarak gönderilen görselleri okur. shannon-2-lite ve shannon-2-pro, tools veya response_format de gönderen isteklerde görselleri okur. Shannon 3 ailesi dokümanları da okur. Görseller ve dosyalar
  • Akıl yürütme. Yanıt, modelin akıl yürütme metnini kendi alanında, yanıtın yanında taşıyabilir. Akıl yürütme çabası
  • Akıl yürütme çabası. Bir istek alanı modelin ne kadar derin akıl yürüteceğini belirler: off, low, medium veya high. Shannon modelleri kendi derinliklerini kendileri belirler. Akıl yürütme çabası
  • JSON nesnesi. response_format: {"type": "json_object"} ile yanıt, belirli bir yapısı olmayan JSON'dır. /v1/chat/completions ve /v1/responses üzerinde. Yapılandırılmış Çıktılar
  • JSON şeması. json_schema türünde bir response_format ile yanıt, gönderdiğiniz bir şemayı izler. /v1/chat/completions ve /v1/responses üzerinde. Yapılandırılmış Çıktılar
  • İstem önbelleğe alma. Aynı modelde yakın zamanlı bir istemle aynı şekilde başlayan istem önbellekten okunur ve önbellekteki kısım giriş fiyatının %25'i üzerinden faturalandırılır. Bir istek alanı gerektirmez. İstem önbelleğe alma
  • Web araması. web_search: true ile API web'de arama yapar ve sonuçları yanıtlamadan önce modele verir. /v1/chat/completions ve /v1/messages üzerinde. Bir istek alanıdır ve GET /v1/models içinde bayrağı yoktur. Yerleşik Web Arama
  • Streaming. stream: true ile yanıt, model yazarken server-sent events olarak gelir. Her model üç uç noktada da streaming yapar. Akış

GET /v1/models üzerinden aynı bilgiler

GET https://api.shannon-ai.com/v1/models

GET /v1/models her modeli bir capabilities nesnesiyle listeler; böylece bir program bu bilgileri bu sayfa yerine oradan okuyabilir. Uç nokta anahtar gerektirmez.

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

data içindeki iki girdinin id ve capabilities alanları:

200 JSON
[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]
Sütun capabilities içindeki bayrak
Araçlar tools
Görsel girdisi vision
Akıl yürütme reasoning
Akıl yürütme çabası reasoning_effort
JSON nesnesi response_format
JSON şeması json_schema
İstem önbelleğe alma prompt_caching
Web araması Bir bayrak değil: istek alanı web_search.
Streaming streaming
  • response_format ve prompt_caching, host edilen açık ağırlıklı girdilerin bayraklarıdır. Bir Shannon girdisi JSON çıktısını yalnızca json_schema ile bildirir; bu, her iki JSON modunu da temsil eder.
  • vision, shannon-2-lite ve shannon-2-pro için true değerindedir: bunlar tools veya response_format de gönderen isteklerde görselleri okur.

Bir modelin satırının dışında

Host edilen bir açık ağırlıklı model, kendi satırının dışında kalan bir görseli veya JSON modunu reddeder. Ret, bakiyenizden herhangi bir şey düşülmeden önce gelir:

Durum Tür Mesaj Ne zaman
400 invalid_request_error <id> does not accept image input Görsel girdisi olmayan host edilen bir açık ağırlıklı modele görsel gönderildi.
400 invalid_request_error <id> does not accept response_format JSON modlarından hiçbirine sahip olmayan, host edilen bir açık ağırlıklı modelden JSON çıktısı istendi.
400 invalid_request_error <id> does not accept response_format json_schema; use json_object Yalnızca JSON nesne moduna sahip, host edilen bir açık ağırlıklı modele şema gönderildi.

Bir Shannon modeli böyle bir isteği 200 durumuyla yanıtlar: satırının dışındaki yetenek yanıta katılmaz. Hata yönetimi