ਸਮਰੱਥਾਵਾਂ

ਹਰ ਮਾਡਲ ਤੱਕ ਇੱਕੋ key ਨਾਲ ਉਹੀ ਤਿੰਨ endpoints ਰਾਹੀਂ ਪਹੁੰਚਿਆ ਜਾਂਦਾ ਹੈ। ਦੋ ਟੇਬਲ ਦਿਖਾਉਂਦੇ ਹਨ ਕਿ ਮਾਡਲ ਕਿੱਥੇ ਵੱਖਰੇ ਹਨ। ਡੈਸ਼ ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਮਾਡਲ ਉਸ ਸਮਰੱਥਾ ਤੋਂ ਬਿਨਾਂ ਜਵਾਬ ਦਿੰਦਾ ਹੈ।

Shannon ਮਾਡਲ

ਹੋਸਟ ਕੀਤੇ open-weight ਮਾਡਲ

ਹੋਸਟ ਕੀਤੇ ਮਾਡਲ ਦੀ id ਉਸ ਦਾ ਨਾਂ ਅਤੇ ਉਸ ਦਾ ਵੈਰੀਐਂਟ ਹਾਈਫਨ ਨਾਲ ਜੋੜ ਕੇ ਬਣਦੀ ਹੈ, ਉਦਾਹਰਣ ਵਜੋਂ DeepSeek-V4-Pro-0813-3BIT-REAP।

ਹਰ ਕਾਲਮ ਦਾ ਮਤਲਬ

• ਟੂਲ. ਤੁਸੀਂ tools ਵਿੱਚ ਫੰਕਸ਼ਨਾਂ ਦਾ ਵਰਣਨ ਕਰਦੇ ਹੋ, ਮਾਡਲ ਉਨ੍ਹਾਂ ਕਾਲਾਂ ਨਾਲ ਜਵਾਬ ਦਿੰਦਾ ਹੈ ਜੋ ਉਹ ਕਰਵਾਉਣਾ ਚਾਹੁੰਦਾ ਹੈ, ਅਤੇ ਤੁਹਾਡਾ ਕੋਡ ਉਨ੍ਹਾਂ ਨੂੰ ਚਲਾਉਂਦਾ ਹੈ। ਹਰ ਮਾਡਲ ਟੂਲ ਲੈਂਦਾ ਹੈ। ਜ਼ਬਰਦਸਤੀ ਵਾਲਾ tool_choice ਹੋਸਟ ਕੀਤੇ open-weight ਮਾਡਲ ਲਾਗੂ ਕਰਦੇ ਹਨ। ਫੰਕਸ਼ਨ ਕਾਲਿੰਗ
• ਇਮੇਜ ਇਨਪੁਟ. ਮਾਡਲ ਉਹ ਇਮੇਜਾਂ ਪੜ੍ਹਦਾ ਹੈ ਜੋ user ਮੈਸੇਜ ਦੇ ਅੰਦਰ data URL ਜਾਂ ਪਤੇ ਵਜੋਂ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। shannon-2-lite ਅਤੇ shannon-2-pro ਉਨ੍ਹਾਂ ਰਿਕੁਐਸਟਾਂ ਵਿੱਚ ਵੀ ਇਮੇਜਾਂ ਪੜ੍ਹਦੇ ਹਨ ਜੋ tools ਜਾਂ response_format ਵੀ ਭੇਜਦੀਆਂ ਹਨ। Shannon 3 ਪਰਿਵਾਰ ਦਸਤਾਵੇਜ਼ ਵੀ ਪੜ੍ਹਦਾ ਹੈ। ਇਮੇਜਾਂ ਅਤੇ ਫਾਈਲਾਂ
• ਰੀਜ਼ਨਿੰਗ. ਜਵਾਬ ਵਿੱਚ ਉੱਤਰ ਦੇ ਨਾਲ ਮਾਡਲ ਦਾ ਰੀਜ਼ਨਿੰਗ ਟੈਕਸਟ ਵੀ, ਆਪਣੇ ਵੱਖਰੇ ਫੀਲਡ ਵਿੱਚ, ਆ ਸਕਦਾ ਹੈ। ਰੀਜ਼ਨਿੰਗ effort
• ਰੀਜ਼ਨਿੰਗ effort. ਇੱਕ ਰਿਕੁਐਸਟ ਫੀਲਡ ਤੈਅ ਕਰਦਾ ਹੈ ਕਿ ਮਾਡਲ ਕਿੰਨੀ ਡੂੰਘੀ ਰੀਜ਼ਨਿੰਗ ਕਰੇ: off, low, medium ਜਾਂ high। Shannon ਮਾਡਲ ਆਪਣੀ ਡੂੰਘਾਈ ਆਪ ਤੈਅ ਕਰਦੇ ਹਨ। ਰੀਜ਼ਨਿੰਗ effort
• JSON object. response_format: {"type": "json_object"} ਨਾਲ ਜਵਾਬ ਬਿਨਾਂ ਕਿਸੇ ਨਿਰਧਾਰਤ ਸ਼ਕਲ ਦਾ JSON ਹੁੰਦਾ ਹੈ। /v1/chat/completions ਅਤੇ /v1/responses ਉੱਤੇ। ਸਟ੍ਰਕਚਰਡ ਆਉਟਪੁੱਟਸ
• JSON schema. json_schema ਕਿਸਮ ਦੇ response_format ਨਾਲ ਜਵਾਬ ਤੁਹਾਡੀ ਭੇਜੀ schema ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ। /v1/chat/completions ਅਤੇ /v1/responses ਉੱਤੇ। ਸਟ੍ਰਕਚਰਡ ਆਉਟਪੁੱਟਸ
• ਪ੍ਰੋਂਪਟ ਕੈਸ਼ਿੰਗ. ਜਿਸ ਪ੍ਰੋਂਪਟ ਦੀ ਸ਼ੁਰੂਆਤ ਉਸੇ ਮਾਡਲ ਉੱਤੇ ਹਾਲ ਹੀ ਦੇ ਪ੍ਰੋਂਪਟ ਵਰਗੀ ਹੋਵੇ, ਉਹ ਕੈਸ਼ ਤੋਂ ਪੜ੍ਹਿਆ ਜਾਂਦਾ ਹੈ, ਅਤੇ ਕੈਸ਼ ਕੀਤੇ ਹਿੱਸੇ ਦਾ ਬਿਲ ਇਨਪੁਟ ਕੀਮਤ ਦੇ 25% ਉੱਤੇ ਬਣਦਾ ਹੈ। ਇਸ ਲਈ ਕਿਸੇ ਰਿਕੁਐਸਟ ਫੀਲਡ ਦੀ ਲੋੜ ਨਹੀਂ। ਪ੍ਰੋਂਪਟ ਕੈਸ਼ਿੰਗ
• ਵੈੱਬ ਸਰਚ. web_search: true ਨਾਲ API ਵੈੱਬ ਉੱਤੇ ਖੋਜ ਕਰਦੀ ਹੈ ਅਤੇ ਜਵਾਬ ਦੇਣ ਤੋਂ ਪਹਿਲਾਂ ਨਤੀਜੇ ਮਾਡਲ ਨੂੰ ਦਿੰਦੀ ਹੈ। /v1/chat/completions ਅਤੇ /v1/messages ਉੱਤੇ। ਇਹ ਰਿਕੁਐਸਟ ਦਾ ਇੱਕ ਫੀਲਡ ਹੈ ਅਤੇ GET /v1/models ਵਿੱਚ ਇਸ ਦਾ ਕੋਈ ਫਲੈਗ ਨਹੀਂ ਹੈ। ਵੈੱਬ ਖੋਜ
• ਸਟ੍ਰੀਮਿੰਗ. stream: true ਨਾਲ ਜਵਾਬ ਮਾਡਲ ਦੇ ਲਿਖਦੇ ਸਮੇਂ server-sent events ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ। ਹਰ ਮਾਡਲ ਤਿੰਨਾਂ endpoints ਉੱਤੇ stream ਕਰਦਾ ਹੈ। ਸਟ੍ਰੀਮਿੰਗ

GET /v1/models ਤੋਂ ਉਹੀ ਤੱਥ

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

GET /v1/models ਹਰ ਮਾਡਲ ਨੂੰ capabilities object ਸਮੇਤ ਸੂਚੀਬੱਧ ਕਰਦਾ ਹੈ, ਤਾਂ ਜੋ ਕੋਈ ਪ੍ਰੋਗਰਾਮ ਇਸ ਪੰਨੇ ਦੀ ਥਾਂ ਇਹ ਤੱਥ ਪੜ੍ਹ ਸਕੇ। endpoint ਨੂੰ key ਦੀ ਲੋੜ ਨਹੀਂ।

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 ਹੋਸਟ ਕੀਤੇ open-weight ਐਂਟਰੀਆਂ ਦੇ ਫਲੈਗ ਹਨ। Shannon ਐਂਟਰੀ JSON ਆਉਟਪੁੱਟ ਨੂੰ ਇਕੱਲੇ json_schema ਨਾਲ ਦੱਸਦੀ ਹੈ, ਜੋ ਦੋਵਾਂ JSON ਮੋਡਾਂ ਦੀ ਥਾਂ ਖੜ੍ਹਦਾ ਹੈ।
• shannon-2-lite ਅਤੇ shannon-2-pro ਲਈ vision true ਹੈ: ਉਹ ਉਨ੍ਹਾਂ ਰਿਕੁਐਸਟਾਂ ਵਿੱਚ ਵੀ ਇਮੇਜਾਂ ਪੜ੍ਹਦੇ ਹਨ ਜੋ tools ਜਾਂ response_format ਵੀ ਭੇਜਦੀਆਂ ਹਨ।

ਮਾਡਲ ਦੀ ਕਤਾਰ ਤੋਂ ਬਾਹਰ

ਹੋਸਟ ਕੀਤਾ open-weight ਮਾਡਲ ਉਸ ਇਮੇਜ ਜਾਂ JSON ਮੋਡ ਤੋਂ ਇਨਕਾਰ ਕਰ ਦਿੰਦਾ ਹੈ ਜੋ ਉਸ ਦੀ ਕਤਾਰ ਤੋਂ ਬਾਹਰ ਹੈ। ਇਨਕਾਰ ਇਸ ਤੋਂ ਪਹਿਲਾਂ ਆਉਂਦਾ ਹੈ ਕਿ ਤੁਹਾਡੇ ਬੈਲੇਂਸ ਵਿੱਚੋਂ ਕੁਝ ਕੱਟਿਆ ਜਾਵੇ:

Shannon ਮਾਡਲ ਅਜਿਹੀ ਰਿਕੁਐਸਟ ਦਾ ਜਵਾਬ ਸਟੇਟਸ 200 ਨਾਲ ਦਿੰਦਾ ਹੈ: ਉਸ ਦੀ ਕਤਾਰ ਤੋਂ ਬਾਹਰ ਦੀ ਸਮਰੱਥਾ ਜਵਾਬ ਵਿੱਚ ਕੋਈ ਹਿੱਸਾ ਨਹੀਂ ਲੈਂਦੀ। ਗਲਤੀਆਂ