ናብ ትሕዝቶ ዝለል
ስእልታትን ፋይላትን

ስእልታትን ፋይላትን

ስእልታት ምስ መልእኽቲ ልኣኽ፦ ኣየኖት ሞዴላት ይቕበልዎም፣ ዝቕበሉ ቅርጽታትን ገደባቶምን።

POST https://api.shannon-ai.com/v1/chat/completions

ስእሊ ኣብ ውሽጢ user መልእኽቲ፣ ከም ሓደ ክፋል content ናቱ ይጓዓዝ። እቲ ኣብነት ናይ ኮምፒተር ፋይል የንብብ ከምኡውን ከም data URL ይልእኾ።

import base64
from openai import OpenAI

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

with open("photo.jpg", "rb") as f:
    image = base64.b64encode(f.read()).decode()

response = client.chat.completions.create(
    model="shannon-3",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What is in this picture?"},
            {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64," + image}},
        ],
    }],
)

print(response.choices[0].message.content)
200 JSON
{
  "id": "chatcmpl-8d1f3a5c7e9b4d2f6a8c0e2b4d6f8a1c",
  "object": "chat.completion",
  "created": 1791590400,
  "model": "shannon-3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A grey cat asleep on a windowsill, with a potted fern beside it.",
        "reasoning_content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 286,
    "completion_tokens": 19,
    "total_tokens": 305
  }
}

ኣየኖት ሞዴላት ስእልታት ይቕበሉ

ሞዴላት የንብብ
shannon-3, shannon-3-pro, shannon-3.1, shannon-3.1-pro ስእልታትን ሰነዳትን፦ PDF፣ Word፣ PowerPoint፣ Excel ከምኡውን ቀሊል-ጽሑፍ ፋይላት።
shannon-1.6-lite, shannon-1.6-pro ስእልታት።
shannon-2-lite, shannon-2-pro ስእልታት፣ ኣብ ጠለባት ብተወሳኺ tools ወይ response_format ዝልእኹ።
Kimi-K3-3BIT-REAP, MiniMax-M3-3BIT-REAP, Kimi-K2.6-W4A16-AUTOROUND-REAP, inkling-W4A16-AUTOROUND-REAP, MiMo-V2.5-W8A16 ስእልታት።
DeepSeek-V4-Pro-0813-3BIT-REAP, GLM-5.2-3BIT-REAP, Nemotron3Ultra-3BIT-REAP, DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP, Laguna-S-2.1-W4A16-AUTOROUND-REAP, MiMo-V2.5-Pro-W8A16, Hy3-W8A16 ጽሑፍ። ስእሊ ዘለዎ ጠለብ ብኩነታት 400 ይምለስ።
shannon-coder-1 ጽሑፍ።

GET /v1/models ስእሊ ኣተዋዕዎ ንነፍሲ ወከፍ id ከም capabilities.vision ይሕብር። ሞዴላትን ዋጋን

  • ሞዴላት Shannon ፋይላት ናይ ዳሕረዋይ user መልእኽቲ የንብቡ። ስእሊ ኣብቲ ብዛዕባኡ ዝሓትት መልእኽቲ ኣእትዎ።
  • ስድራ Shannon 3 ገለ ስእልታትን ሰነዳትን ናይ ዝሓለፉ user መልእኽትታት inline ምስ ዝልኣኹ ኣብ ግምት ይሕዞም፣ ከምኡውን ካብ ቀዳማይ ጀሚሩ ዝቝጸር ዝተወሰነ ላዕለዋይ ቁጽሪ ስእልታት ንነፍሲ ወከፍ ጠለብ የንብብ።
  • ዝተሃንደሱ open-weight ሞዴላት ስእልታት ናይ ነፍሲ ወከፍ መልእኽቲ ናይ ዘተ የንብቡ።

ዝቕበሉ ቅርጽታት

ፋይል ብሓደ ካብ ክልተ ኣገባባት ይለኣኽ፦ ኣብ ውሽጢ ጠለብ ከም base64፣ ወይ ከም እቲ API ዝረኽቦ ኣድራሻ። ነፍሲ ወከፍ ፋይል ምስ ጠለብ ይጓዓዝ፤ እቲ API upload endpoint የብሉን።

Endpoint ኣብ ጠለብ (base64) ብኣድራሻ
/v1/chat/completions {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,…"}} {"type": "image_url", "image_url": {"url": "https://…"}}
/v1/responses {"type": "input_image", "image_url": "data:image/jpeg;base64,…"} {"type": "input_image", "image_url": "https://…"}
/v1/messages {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": "…"}} {"type": "image", "source": {"type": "url", "url": "https://…"}}

እቲ ተመሳሳሊ user መልእኽቲ ኣብ ነፍሲ ወከፍ ቅርጺ፦

{
  "role": "user",
  "content": [
    {"type": "text", "text": "What is in this picture?"},
    {
      "type": "image_url",
      "image_url": {
        "url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD…"
      }
    }
  ]
}
  • data URL ቅርጺ data:<media type>;base64,<data> ኣለዎ። እቲ ;base64 ክፋል ግዴታ እዩ።
  • ኣብ /v1/chat/completions ከምኡውን /v1/responses፣ image_url እቲ string ባዕሉ ወይ object {"url": "…"} ክኸውን ይኽእል።
  • ዓይነት ፋይል ካብ data URL ወይ ካብ media_type ይመጽእ። ብዘይ እዚ፣ ስእሊ ከም image/png ይነበብ።
  • Inline ፋይላት ኣብ ዓቐን request body ይቝጸሩ፣ ክሳብ 32 MiB ክኸውን ዝኽእል።
  • ንምስምማዕ ይቕበል፦ image_url.detail።

ገደባት ንርሑቕ ፋይላት

ኣድራሻ ምስ ትልእኽ፣ እቲ API ቅድሚ እቲ ሞዴል ምስራሑ ነቲ ፋይል ኣብዞም ገደባት ይረኽቦ፦

ገደብ ሕጊ
ዓቐን ክሳብ 8 MiB ንነፍሲ ወከፍ ፋይል።
ግዜ 20 ሰከንድ ንምምላስ።
Redirects ክሳብ 5።
ኣድራሻ http:// ወይ https://፣ ብዘይ ስም ተጠቃሚ ወይ ቃል ምስጢር ኣብ ኣድራሻ፣ ኣብ ህዝባዊ ኣድራሻ ዘለዎ host።
ምላሽ ናይ host ኩነታት ኣብ ዓይነት 200 ከምኡውን ባዶ ዘይኮነ body። ዓይነት ፋይል ካብ Content-Type ይነበብ።
ከም ዝሕተት User-Agent: ShannonBot/1.0 (+https://shannon-ai.com)

ስእልታት ብ tokens ከመይ ይቝጸሩ

ኣብ ዝተሃንደሱ open-weight ሞዴላት ስእሊ ንነፍሲ ወከፍ 28 × 28 pixel patch ሓደ token ይቝጸር፦ ወርድ ብ28 ዝተመቐለ ናብ ላዕሊ ዝተጠጋጋዐ፣ ብልዑል ብ28 ዝተመቐለ ናብ ላዕሊ ዝተጠጋጋዐ ተባዚዑ። እቲ ውጽኢት ክፋል ናይ usage.prompt_tokens እዩ ከምኡውን ከም ኣተዋዕዎ ይኽፈል።

1024 × 1024
1,369 tokens
1920 × 1080
2,691 tokens
512 × 512
361 tokens
  • ርሑቕ ስእሊ መጀመርታ ይረኸብ፣ ስለዚ ሓቀኛ ዓቐኑ ይቝጸር።
  • ዓቐኑ ክነበብ ዘይክእል ስእሊ 1,024 tokens ይቝጸር።
  • እቶም ቆጸራ endpoints ንdata URLs ተመሳሳሊ ሕጊ ይጥቀሙ። ርሑቕ ኣድራሻ ኣይረኽቡን ከምኡውን ከም 1,024 tokens ይቝጽርዎ። ምቑጻር Token
  • ንሞዴል Shannon፣ ስእልታት ዘለዎ ጠለብ ክንደይ ከም ዝኸፈለ ካብ usage ኣብ ምላሽ ኣንብብ።

ሰነዳትን ካልኦት ፋይላትን

ስድራ Shannon 3 (shannon-3, shannon-3-pro, shannon-3.1, shannon-3.1-pro) ሰነዳት እውን የንብብ። እቲ ጽሑፍ ናይ ሰነድ ይወጽእ እሞ ምስ መልእኽትካ ንሞዴል ይወሃብ።

ሰነድ ዓይነት media
PDF application/pdf
Word application/vnd.openxmlformats-officedocument.wordprocessingml.document
PowerPoint application/vnd.openxmlformats-officedocument.presentationml.presentation
Excel application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

ሰነድ ከም ስእሊ ክፋል ናይ user መልእኽቲ እዩ፦

Endpoint ኣብ ጠለብ (base64) ብኣድራሻ
/v1/chat/completions, /v1/messages {"type": "document", "source": {"type": "base64", "media_type": "application/pdf", "data": "…"}} {"type": "document", "source": {"type": "url", "url": "https://…"}}
/v1/responses {"type": "input_file", "file_data": "data:application/pdf;base64,…"} {"type": "input_file", "file_url": "https://…"}
{
  "model": "shannon-3",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "document",
          "source": {
            "type": "base64",
            "media_type": "application/pdf",
            "data": "JVBERi0xLjcKJeLjz9MK…"
          }
        },
        {"type": "text", "text": "Summarise this report in five points."}
      ]
    }
  ]
}
  • ልክዕ media type ናይ ፋይል ሃብ። ብዘይ እዚ፣ ሰነድ ከም application/pdf ይነበብ።
  • ቀሊል-ጽሑፍ ፋይል፣ ከም CSV፣ ከም ጽሑፍ ይነበብ ከምኡውን ብተመሳሳሊ ኣገባብ ይተሓሓዝ።
  • ሰነድ ክነበብ ምስ ዘይክእል፣ ወይ እቲ ፋይል ካልእ ዓይነት ምስ ዝኸውን፣ ነቲ ሞዴል ይነግርዎ ከምኡውን ኣብ መልሱ ክብሎ ይኽእል። እቲ ኩነታት ገና 200 እዩ።
  • ኣብ ነፍሲ ወከፍ ካልእ ሞዴል ክፋል ሰነድ ካብቲ እቲ ሞዴል ዘንብቦ ይወጽእ፣ እቲ ጠለብ ድማ ካብ ዝተረፈ ይምለስ።
  • ብኣድራሻ ዝተላእከ ሰነድ ኣብ ላዕሊ ብዛዕባ ርሑቕ ፋይላት ዘሎ ገደባት ይመጽእ።

ጌጋታት

ኩነታት ዓይነት መልእኽቲ መዓስ
400 invalid_request_error <id> does not accept image input ስእሊ ናብ ጽሑፍ ጥራይ ዝቕበል ዝተሃንደሰ open-weight ሞዴል ተላኢኹ። ካብ ሚዛንካ ዋላ ሓንቲ ኣይውሰድን።
400 invalid_request_error audio and video input are not supported by any hosted model ኦዲዮ ወይ ቪድዮ ክፍሊ ናብ ዝተሃንደሰ open-weight ሞዴል ተላኢኹ።
413 invalid_request_error Failed to buffer the request body: … እቲ request body ምስ inline ፋይላቱ ካብ 32 MiB ይዓቢ። እቲ ጌጋ code: "request_too_large" ይሓዝ።

ሞዴል Shannon እቲ ጠለብ ዝኾነ ፋይላት ይሓዝ ብኩነታት 200 ይምልስ፦ ዘየንብቦ ክፋል ይወጽእ። ሓጋይ ኣስተዳደር