Gaitasunak

Modelo guztietara hiru endpoint beretik iristen da, gako berarekin. Bi taulek modeloak non bereizten diren erakusten dute. Marratxo batek esan nahi du modeloak gaitasun horrik gabe erantzuten duela.

Shannon modeloak

Pisu irekiko modelo ostatatuak

Modelo ostatatu baten id-a bere izena eta bere aldaera gidoiz lotuta dira, adibidez DeepSeek-V4-Pro-0813-3BIT-REAP.

Zutabe bakoitzak zer esan nahi duen

• Tresnak. Funtzioak tools-en deskribatzen dituzu, modeloak egin nahi dituen deiekin erantzuten du, eta zure kodeak exekutatzen ditu. Modelo guztiek tresnak hartzen dituzte. Behartutako tool_choice bat pisu irekiko modelo ostatatuek aplikatzen dute. Funtzio-deiak
• Irudi-sarrera. Modeloak erabiltzaile-mezu baten barruan bidalitako irudiak irakurtzen ditu, data URL gisa edo helbide gisa. shannon-2-lite eta shannon-2-pro irudiak irakurtzen dituzte tools edo response_format ere bidaltzen duten eskaeretan. Shannon 3 familiak dokumentuak ere irakurtzen ditu. Irudiak eta fitxategiak
• Arrazonamendua. Erantzunak modeloaren arrazonamendu-testua eraman dezake erantzunaren ondoan, eremu propio batean. Arrazonamendu-esfortzua
• Arrazonamendu-esfortzua. Eskaera-eremu batek ezartzen du modeloak zein sakonki arrazoitzen duen: off, low, medium edo high. Shannon modeloek beren sakonera propioa ezartzen dute. Arrazonamendu-esfortzua
• JSON objektua. response_format: {"type": "json_object"} erabiliz erantzuna JSON da, forma jakinik gabe. /v1/chat/completions eta /v1/responses endpoint-etan. Irteera egituratuak
• JSON eskema. json_schema motako response_format erabiliz erantzunak zuk bidalitako eskema jarraitzen du. /v1/chat/completions eta /v1/responses endpoint-etan. Irteera egituratuak
• Prompt cachea. Modelo berean duela gutxiko prompt baten antzera hasten den prompt bat cachetik irakurtzen da, eta cacheko zatia sarrera-prezioaren % 25ean fakturatzen da. Ez du eskaera-eremurik behar. Prompt-cache
• Web bilaketa. web_search: true erabiliz API-ak weba bilatzen du eta emaitzak modeloari ematen dizkio erantzun aurretik. /v1/chat/completions eta /v1/messages endpoint-etan. Eskaeraren eremu bat da eta ez du flag-ik GET /v1/models-en. Web bilaketa
• Streaminga. stream: true erabiliz erantzuna server-sent events gisa iristen da modeloak idazten duen bitartean. Modelo guztiek streaming egiten dute hiru endpoint-etan. Streaminga

Datu berberak GET /v1/models bidez

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

GET /v1/models-ek modelo guztiak zerrendatzen ditu capabilities objektu batekin, programa batek datu hauek orrialde honetan irakurri beharrean irakur ditzan. Endpoint-ak ez du gakorik behar.

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))

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });

for await (const model of client.models.list()) {
  console.log(model.id, model.capabilities);
}

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

data-ren bi sarreraren id eta capabilities:

[
  {
    "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
    }
  }
]

• response_format eta prompt_caching pisu irekiko sarrera ostatatuen flag-ak dira. Shannon sarrera batek JSON irteera json_schema bakarrik erabiliz jakinarazten du, eta honek bi JSON moduak adierazten ditu.
• vision true da shannon-2-lite eta shannon-2-pro modeloentzat: irudiak irakurtzen dituzte tools edo response_format ere bidaltzen duten eskaeretan.

Modelo baten errenkadatik kanpo

Pisu irekiko modelo ostatatu batek bere errenkadatik kanpoko irudia edo JSON modua ukatzen du. Ukapena zure saldotik ezer kendu aurretik gertatzen da:

Shannon modelo batek halako eskaerari 200 egoerarekin erantzuten dio: bere errenkadatik kanpoko gaitasunak ez du erantzunean parte hartzen. Errore‑kudeaketa