ስእልታትን ፋይላትን
ስእልታት ምስ መልእኽቲ ልኣኽ፦ ኣየኖት ሞዴላት ይቕበልዎም፣ ዝቕበሉ ቅርጽታትን ገደባቶምን።
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) import fs from "node:fs";
import OpenAI from "openai";
const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });
const image = fs.readFileSync("photo.jpg").toString("base64");
const response = await 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 } },
],
}],
});
console.log(response.choices[0].message.content); # Linux: base64 -w0 photo.jpg macOS: base64 -i photo.jpg
IMAGE=$(base64 -w0 photo.jpg)
curl https://api.shannon-ai.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<EOF
{
"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}"}}
]
}]
}
EOF {
"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…"
}
}
]
} {
"role": "user",
"content": [
{"type": "input_text", "text": "What is in this picture?"},
{
"type": "input_image",
"image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD…"
}
]
} {
"role": "user",
"content": [
{"type": "text", "text": "What is in this picture?"},
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/jpeg",
"data": "/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 |
|---|---|
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."}
]
}
]
} {
"model": "shannon-3",
"input": [
{
"role": "user",
"content": [
{
"type": "input_file",
"file_data": "data:application/pdf;base64,JVBERi0xLjcKJeLjz9MK…"
},
{
"type": "input_text",
"text": "Summarise this report in five points."
}
]
}
]
} {
"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 ይምልስ፦ ዘየንብቦ ክፋል ይወጽእ። ሓጋይ ኣስተዳደር