Δυνατότητες

Κάθε μοντέλο προσεγγίζεται μέσω των ίδιων τριών endpoints με το ίδιο κλειδί. Οι δύο πίνακες δείχνουν πού διαφέρουν τα μοντέλα. Μια παύλα σημαίνει ότι το μοντέλο απαντά χωρίς αυτή τη δυνατότητα.

Μοντέλα Shannon

Φιλοξενούμενα μοντέλα ανοιχτών βαρών

Το id ενός φιλοξενούμενου μοντέλου είναι το όνομά του και η παραλλαγή του ενωμένα με παύλα, για παράδειγμα DeepSeek-V4-Pro-0813-3BIT-REAP.

Τι σημαίνει κάθε στήλη

• Εργαλεία. Περιγράφετε συναρτήσεις στο tools, το μοντέλο απαντά με τις κλήσεις που θέλει να γίνουν και ο κώδικάς σας τις εκτελεί. Κάθε μοντέλο δέχεται εργαλεία. Ένα εξαναγκασμένο tool_choice εφαρμόζεται από τα φιλοξενούμενα μοντέλα ανοιχτών βαρών. Κλήση συναρτήσεων
• Είσοδος εικόνας. Το μοντέλο διαβάζει εικόνες που στέλνονται μέσα σε μήνυμα χρήστη, ως data URL ή ως διεύθυνση. Τα shannon-2-lite και shannon-2-pro διαβάζουν εικόνες σε αιτήματα που στέλνουν επίσης tools ή response_format. Η οικογένεια Shannon 3 διαβάζει και έγγραφα. Εικόνες και αρχεία
• Συλλογισμός. Η απάντηση μπορεί να φέρει το κείμενο συλλογισμού του μοντέλου δίπλα στην απάντηση, σε δικό του πεδίο. Προσπάθεια συλλογισμού
• Προσπάθεια συλλογισμού. Ένα πεδίο αιτήματος ορίζει πόσο βαθιά συλλογίζεται το μοντέλο: off, low, medium ή high. Τα μοντέλα Shannon ορίζουν μόνα τους το βάθος. Προσπάθεια συλλογισμού
• Αντικείμενο JSON. Με response_format: {"type": "json_object"} η απάντηση είναι JSON χωρίς καθορισμένη μορφή. Στα /v1/chat/completions και /v1/responses. Δομημένες έξοδοι
• JSON schema. Με response_format τύπου json_schema η απάντηση ακολουθεί ένα schema που στέλνετε. Στα /v1/chat/completions και /v1/responses. Δομημένες έξοδοι
• Prompt caching. Ένα prompt που αρχίζει όπως ένα πρόσφατο στο ίδιο μοντέλο διαβάζεται από το cache και το cached μέρος χρεώνεται στο 25% της τιμής εισόδου. Δεν χρειάζεται πεδίο αιτήματος. Caching ερωτημάτων
• Αναζήτηση στον ιστό. Με web_search: true το API αναζητά στον ιστό και δίνει τα αποτελέσματα στο μοντέλο πριν απαντήσει. Στα /v1/chat/completions και /v1/messages. Είναι πεδίο του αιτήματος και δεν έχει flag στο GET /v1/models. Ενσωματωμένη αναζήτηση ιστού
• Streaming. Με stream: true η απάντηση φτάνει ως server-sent events καθώς γράφει το μοντέλο. Κάθε μοντέλο κάνει streaming και στα τρία endpoints. Ροή

Τα ίδια στοιχεία από το GET /v1/models

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

Το GET /v1/models απαριθμεί κάθε μοντέλο με ένα αντικείμενο capabilities, ώστε ένα πρόγραμμα να διαβάζει αυτά τα στοιχεία αντί γι' αυτή τη σελίδα. Το endpoint δεν χρειάζεται κλειδί.

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

Το id και το capabilities δύο εγγραφών του data:

[
  {
    "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 είναι flags των εγγραφών φιλοξενούμενων μοντέλων ανοιχτών βαρών. Μια εγγραφή Shannon αναφέρει έξοδο JSON μόνο με το json_schema, που αντιπροσωπεύει και τα δύο modes JSON.
• Το vision είναι true για τα shannon-2-lite και shannon-2-pro: διαβάζουν εικόνες σε αιτήματα που στέλνουν επίσης tools ή response_format.

Εκτός της γραμμής ενός μοντέλου

Ένα φιλοξενούμενο μοντέλο ανοιχτών βαρών απορρίπτει μια εικόνα ή ένα mode JSON που είναι εκτός της γραμμής του. Η απόρριψη γίνεται πριν αφαιρεθεί οτιδήποτε από το υπόλοιπό σας:

Ένα μοντέλο Shannon απαντά σε ένα τέτοιο αίτημα με κατάσταση 200: η δυνατότητα εκτός της γραμμής του δεν παίρνει μέρος στην απάντηση. Χειρισμός σφαλμάτων