படங்களும் கோப்புகளும்
செய்தியுடன் படங்களை அனுப்புங்கள்: எந்த மாடல்கள் அவற்றை ஏற்கின்றன, ஏற்கப்படும் வடிவங்கள் மற்றும் அவற்றின் வரம்புகள்.
POST https://api.shannon-ai.com/v1/chat/completions
படம் ஒரு பயனர் செய்திக்குள், அதன் 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 மற்றும் plain-text கோப்புகள். |
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 மாடல்கள் கடைசிப் பயனர் செய்தியின் கோப்புகளைப் படிக்கும். படத்தைப் பற்றிக் கேட்கும் செய்தியிலேயே படத்தை வையுங்கள்.
- Shannon 3 குடும்பம், முந்தைய பயனர் செய்திகளின் சில படங்களையும் ஆவணங்களையும், அவை inline ஆக அனுப்பப்பட்டிருந்தால், கவனத்தில் வைத்திருக்கும்; மேலும் ஒரு கோரிக்கைக்கு முதலிலிருந்து எண்ணி நிர்ணயிக்கப்பட்ட அதிகபட்ச எண்ணிக்கை வரை படங்களைப் படிக்கும்.
- ஹோஸ்ட் செய்யப்பட்ட open-weight மாடல்கள் உரையாடலின் ஒவ்வொரு செய்தியிலுள்ள படங்களையும் படிக்கும்.
ஏற்கப்படும் வடிவங்கள்
கோப்பு இரண்டு வழிகளில் ஒன்றில் அனுப்பப்படும்: கோரிக்கைக்குள்ளேயே base64 ஆக, அல்லது API பெறும் முகவரியாக. ஒவ்வொரு கோப்பும் கோரிக்கையுடனேயே பயணிக்கும்; API-க்கு பதிவேற்ற 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://…"}} |
ஒவ்வொரு வடிவத்திலும் அதே பயனர் செய்தி:
{
"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 ஆகவோ{"url": "…"}object ஆகவோ இருக்கலாம்.- கோப்பு வகை data URL-லிருந்து அல்லது
media_type-லிருந்து பெறப்படும். அது இல்லாவிட்டால், படம்image/pngஆகப் படிக்கப்படும். - inline கோப்புகள் கோரிக்கை body-யின் அளவில் சேரும்; அது 32 MiB வரை இருக்கலாம்.
- இணக்கத்துக்காக ஏற்கப்படுவது:
image_url.detail.
தொலைநிலைக் கோப்புகளுக்கான வரம்புகள்
நீங்கள் முகவரியை அனுப்பும்போது, மாடல் இயங்கும் முன் API இந்த வரம்புகளுக்குள் கோப்பைப் பெறும்:
| வரம்பு | விதி |
|---|---|
| அளவு | ஒரு கோப்புக்கு 8 MiB வரை. |
| நேரம் | பதிலளிக்க 20 வினாடிகள். |
| திசைதிருப்பல்கள் | அதிகபட்சம் 5. |
| முகவரி | http:// அல்லது https://, முகவரியில் பயனர் பெயரோ கடவுச்சொல்லோ இல்லாமல், பொது முகவரி கொண்ட host-ல். |
| host-ன் பதில் | 200 வரம்பிலுள்ள நிலை மற்றும் காலியாக இல்லாத body. கோப்பு வகை Content-Type-லிருந்து படிக்கப்படும். |
| கோரப்படும் விதம் | User-Agent: ShannonBot/1.0 (+https://shannon-ai.com) |
படங்கள் டோக்கன்களில் எவ்வாறு கணக்கிடப்படுகின்றன
ஹோஸ்ட் செய்யப்பட்ட open-weight மாடல்களில் ஒரு படம் ஒவ்வொரு 28 × 28 பிக்சல் பகுதிக்கும் ஒரு டோக்கனாகக் கணக்கிடப்படும்: அகலத்தை 28-ஆல் வகுத்து மேல்நோக்கி முழுதாக்கியதை, உயரத்தை 28-ஆல் வகுத்து மேல்நோக்கி முழுதாக்கியதால் பெருக்கவும். இதன் விளைவு usage.prompt_tokens-ன் பகுதி, உள்ளீடாகக் கட்டணம் விதிக்கப்படும்.
- 1024 × 1024
- 1,369 டோக்கன்கள்
- 1920 × 1080
- 2,691 டோக்கன்கள்
- 512 × 512
- 361 டோக்கன்கள்
- தொலைநிலைப் படம் முதலில் பெறப்படும், எனவே அதன் உண்மையான அளவு எண்ணப்படும்.
- அளவைப் படிக்க முடியாத படம் 1,024 டோக்கன்களாக எண்ணப்படும்.
- எண்ணிக்கை endpoint-கள் data URL-களுக்கு அதே விதியைப் பயன்படுத்துகின்றன. அவை தொலைநிலை முகவரியைப் பெறாது, அதை 1,024 டோக்கன்களாக எண்ணும். Token எண்ணிக்கை
- Shannon மாடலில், படங்கள் உள்ள கோரிக்கைக்கு எவ்வளவு செலவானது என்பதை பதிலின்
usage-லிருந்து படியுங்கள்.
ஆவணங்களும் பிற கோப்புகளும்
Shannon 3 குடும்பம் (shannon-3, shannon-3-pro, shannon-3.1, shannon-3.1-pro) ஆவணங்களையும் படிக்கும். ஆவணத்தின் உரை பிரித்தெடுக்கப்பட்டு உங்கள் செய்தியுடன் மாடலுக்குத் தரப்படும்.
| ஆவணம் | Media type |
|---|---|
application/pdf | |
| Word | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
| PowerPoint | application/vnd.openxmlformats-officedocument.presentationml.presentation |
| Excel | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
படத்தைப் போலவே, ஆவணமும் பயனர் செய்தியின் ஒரு பகுதி:
| 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 போன்ற plain-text கோப்பு உரையாகப் படிக்கப்பட்டு அதே முறையில் இணைக்கப்படும்.
- ஆவணத்தைப் படிக்க முடியாதபோது, அல்லது கோப்பு வேறு வகையாக இருக்கும்போது, மாடலுக்கு அது தெரிவிக்கப்படும், அது தன் பதிலில் அதைச் சொல்லலாம். நிலை இன்னும்
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: … | inline கோப்புகளுடன் சேர்ந்த கோரிக்கை body 32 MiB-ஐ விடப் பெரியது. பிழையில் code: "request_too_large" இருக்கும். |
கோரிக்கையில் எந்தக் கோப்புகள் இருந்தாலும் Shannon மாடல் நிலை 200 உடன் பதிலளிக்கும்: அது படிக்காத பகுதி நீக்கப்படும். கையாளுவதில் பிழை