Чадварууд

Загвар бүр ижил гурван endpoint-оор, ижил түлхүүрээр хандагдана. Хоёр хүснэгт загваруудын ялгааг харуулна. Зураас гэдэг нь загвар тэр чадваргүйгээр хариулна гэсэн үг.

Shannon загварууд

Hosted open-weight загварууд

Hosted загварын id нь түүний нэр ба хувилбарыг зураасаар холбосон байна, жишээ нь DeepSeek-V4-Pro-0813-3BIT-REAP.

Багана бүр юу гэсэн үг

• Tools. Та tools дотор функцүүдийг тодорхойлно, загвар хийлгэхийг хүссэн дуудлагуудаар хариулна, таны код тэдгээрийг ажиллуулна. Загвар бүр tools хүлээн авна. Албадсан tool_choice-ийг hosted open-weight загварууд хэрэгжүүлнэ. Функц дуудлага
• Зураг оролт. Загвар хэрэглэгчийн мессеж доторх data URL эсвэл хаяг хэлбэрээр илгээсэн зургийг уншина. shannon-2-lite ба shannon-2-pro нь tools эсвэл response_format илгээсэн хүсэлтэд ч зургийг уншина. Shannon 3 гэр бүл баримтыг бас уншина. Зураг ба файл
• Reasoning. Хариулт нь загварын reasoning текстийг хариултын хажууд тусдаа талбарт агуулж болно. Reasoning effort
• Reasoning effort. Хүсэлтийн талбар нь загвар хэр гүн reasoning хийхийг тогтооно: off, low, medium эсвэл high. Shannon загварууд гүнээ өөрсдөө тогтооно. Reasoning effort
• JSON объект. response_format: {"type": "json_object"} үед хариулт заасан бүтэцгүй JSON байна. /v1/chat/completions ба /v1/responses дээр. Бүтэцтэй гаралт
• JSON schema. json_schema төрлийн response_format үед хариулт таны илгээсэн schema-г дагана. /v1/chat/completions ба /v1/responses дээр. Бүтэцтэй гаралт
• Prompt кэшлэл. Ижил загвар дээрх саяхны prompt-той адилхан эхэлсэн prompt кэшээс уншигдах бөгөөд кэшлэгдсэн хэсгийг оролтын үнийн 25%-иар тооцно. Хүсэлтийн талбар шаардахгүй. Prompt кэшлэл
• Вэб хайлт. web_search: true үед API вэбээс хайж, загвар хариулахаас өмнө үр дүнг түүнд өгнө. /v1/chat/completions ба /v1/messages дээр. Энэ нь хүсэлтийн талбар бөгөөд GET /v1/models дотор flag-гүй. Вэб хайлт
• Streaming. stream: true үед хариулт загвар бичиж байх үед server-sent events хэлбэрээр ирнэ. Загвар бүр гурван endpoint дээр stream хийнэ. Дамжуулалт

GET /v1/models-оос ижил мэдээлэл

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

GET /v1/models нь загвар бүрийг capabilities объекттой жагсаадаг тул программ эдгээр баримтыг энэ хуудаснаас биш эндээс уншиж болно. Endpoint түлхүүр шаардахгүй.

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-ийн хоёр элементийн id ба 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 ба prompt_caching нь hosted open-weight элементүүдийн flag. Shannon элемент JSON гаралтыг зөвхөн json_schema-аар мэдээлэх бөгөөд энэ нь хоёр JSON горимыг хоёуланг нь илэрхийлнэ.
• vision нь shannon-2-lite ба shannon-2-pro дээр true: тэд tools эсвэл response_format илгээсэн хүсэлтэд ч зургийг уншина.

Загварын мөрөөс гадуур

Hosted open-weight загвар өөрийн мөрөөс гадуурх зураг эсвэл JSON горимыг татгалзана. Татгалзал нь таны үлдэгдлээс юм хасахаас өмнө гарна:

Shannon загвар ийм хүсэлтэд 200 төлөвөөр хариулна: мөрөөс гадуурх чадвар хариултад оролцохгүй. Алдаа боловсруулах