உள்ளடக்கத்துக்குச் செல்
படங்களும் கோப்புகளும்

படங்களும் கோப்புகளும்

செய்தியுடன் படங்களை அனுப்புங்கள்: எந்த மாடல்கள் அவற்றை ஏற்கின்றன, ஏற்கப்படும் வடிவங்கள் மற்றும் அவற்றின் வரம்புகள்.

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)
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 மற்றும் 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…"
      }
    }
  ]
}
  • 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
PDF 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."}
      ]
    }
  ]
}
  • கோப்பின் உண்மையான 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 உடன் பதிலளிக்கும்: அது படிக்காத பகுதி நீக்கப்படும். கையாளுவதில் பிழை