GET /v1/models

Επιστρέφει κάθε ενεργοποιημένο μοντέλο που είναι διαθέσιμο στο πιστοποιημένο κλειδί API. Οι τιμές είναι δεκαδικές συμβολοσειρές σε USD ανά ένα εκατομμύριο μάρκες.

Πιστοποίηση

Authorization: Bearer mg_live_...

x-api-key: mg_live_... είναι επίσης αποδεκτό.

Πλήκτρα με κατάσταση active ή frozen μπορεί να διαβάσει τον κατάλογο μοντέλων και την τιμολόγησή τους για κάθε κλειδί. Ένα παγωμένο κλειδί παραμένει αποκλεισμένο από τα τελικά σημεία συμπερασμάτων και από άλλα τελικά σημεία μεταδεδομένων λογαριασμού που απαιτούν ενεργό κλειδί.

Αίτηση

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

Απάντηση

{
  "object": "list",
  "data": [
    {
      "id": "claude-opus-4.7",
      "object": "model",
      "owned_by": "anthropic",
      "display_name": "Claude Opus 4.7",
      "aliases": ["ch-47"],
      "currency": "USD",
      "pricing_unit": "per_1m_tokens",
      "cost": {
        "input": "0.2",
        "output": "1",
        "cache_read": "0.02",
        "cache_write": "0.25",
        "reasoning": "1"
      },
      "official_cost": {
        "input": "1",
        "output": "5",
        "cache_read": "0.1",
        "cache_write": "1.25",
        "reasoning": "5"
      },
      "usage_cost": {
        "input": "10",
        "output": "50",
        "cache_read": "1",
        "cache_write": "12.5",
        "reasoning": "50"
      },
      "usage_pricing": {
        "basis": "official_price",
        "multiplier": "10",
        "inherited_from": "key"
      },
      "batch_cost": {
        "input": "0.1",
        "output": "0.5",
        "cache_read": "0.01",
        "cache_write": "0.125",
        "reasoning": "0.5"
      },
      "batch_pricing": {
        "multiplier": "0.5",
        "applies_to": "claude_openai_compat_batches"
      },
      "context_length": 200000,
      "context_window": 200000,
      "max_input_tokens": 180000,
      "max_output_tokens": 20000,
      "max_completion_tokens": 20000,
      "supports_streaming": true,
      "supports_tools": true,
      "supports_vision": true
    }
  ]
}

Πεδία τιμών

• cost είναι το πραγματικό επιτόκιο της πύλης μοντέλου που χρησιμοποιείται για τη χρέωση του υπολοίπου του λογαριασμού.
• official_cost είναι η αποθηκευμένη τιμή επίσημου καταλόγου παρόχων.
• usage_cost είναι ο αποτελεσματικός ρυθμός που χρησιμοποιείται μόνο για τα όρια χρήσης κλειδιού API και ομάδας με δυνατότητα επαναφοράς.
• usage_pricing προσδιορίζει τη βάση, τον πολλαπλασιαστή και την πηγή κληρονομικότητας για το κλειδί ελέγχου ταυτότητας.
• Όταν το πρότυπο χρέωσης λογαριασμού έχει συντελεστή δέσμης διαφορετικό από 1, batch_cost δείχνει τις πραγματικές πραγματικές τιμές για παρτίδες συμβατές με Claude/OpenAI και batch_pricing.multiplier προσδιορίζει τον πρόσθετο συντελεστή πύλης μοντέλου. Αυτά τα πεδία υπό όρους παραλείπονται όταν ο συντελεστής είναι 1. Ντόπιος async=true δεν χρησιμοποιεί αυτόν τον συντελεστή.

Για official_price, εμφανίζεται το καθένα usage_cost ποσοστό είναι official_cost × multiplier. Για user_price, είναι cost × multiplier. Αυτές είναι τιμές καταλόγου ανά εκατομμύριο. Η τελική διευθέτηση αιτημάτων υπολογίζει πρώτα και στρογγυλοποιεί το επιλεγμένο βασικό αίτημα σε 10 δεκαδικά ψηφία, στη συνέχεια εφαρμόζει τον πολλαπλασιαστή και στρογγυλοποιεί το αποτέλεσμα σε 10 δεκαδικά ψηφία.

Πεδία ορίου μοντέλου

• context_window είναι η τιμή του παραθύρου περιβάλλοντος που βλέπει τον πελάτη και ισούται προς το παρόν context_length.
• max_input_tokens είναι η ρυθμισμένη μέγιστη τιμή του διακριτικού εισόδου όταν είναι γνωστή.
• max_output_tokens είναι η ρυθμισμένη μέγιστη τιμή διακριτικού εξόδου όταν είναι γνωστή.
• max_completion_tokens είναι το πεδίο συμβατότητας ορίου ολοκλήρωσης που χρησιμοποιείται από μεταδεδομένα μοντέλου τύπου παρόχου.
• Μια αριθμητική τιμή του 0 σημαίνει ότι το Model Gate δεν έχει διαμορφωμένη τιμή για αυτό το όριο. Οι πελάτες με προαιρετικές μη αυτόματες παρακάμψεις ορίων θα πρέπει να αφήσουν αυτήν τη ρύθμιση ακατάλληλη αντί να τη θεραπεύσουν 0 ως πραγματικό όριο μοντέλου ή εικασία άλλης τιμής.

Το πιστοποιημένο /models εμφανίζεται επίσης η σελίδα Συμφραζόμενα, Μέγιστη είσοδος, και Μέγιστη απόδοση για γνωστές μη μηδενικές τιμές, επομένως οι απλοί χρήστες δεν χρειάζεται να υποβάλουν ερωτήματα στο API απλώς για να αντιγράψουν αυτά τα όρια σε μια διαμόρφωση πελάτη.

Σφάλματα

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "missing API key"
  }
}