POST /v1/messages

Πιστοποίηση

x-api-key: mg_live_...
anthropic-version: 2023-06-01
content-type: application/json

Ο έλεγχος ταυτότητας κομιστή είναι επίσης αποδεκτός.

Αίτηση

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a short release note."}
    ]
  }'

Απάντηση

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [{"type": "text", "text": "This release improves documentation and model routing."}],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 11,
    "output_tokens": 9,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Ροή

Προσθέτω "stream": true. Το Model Gate προωθεί συμβάντα SSE συμβατά με Anthropic και καταγράφει την τελική χρήση διακριτικού για τακτοποίηση.

Ψευδώνυμα και λογιστική

Εάν παρέχεται ένα ψευδώνυμο, αντικαθίσταται με το κανονικό μοντέλο προτού το αίτημα μπει στην ουρά ή σταλεί ανάντη. Η τιμολόγηση, το κόστος χρήσης, το ιστορικό αιτημάτων και οι περιορισμοί μοντέλων χρησιμοποιούν το κανονικό μοντέλο.

Κατάσταση	Εννοια	Δράση
400	Μη έγκυρο αίτημα	Ελέγξτε το σώμα του αιτήματος και το αναγνωριστικό μοντέλου.
401	Μη έγκυρο ή παγωμένο κλειδί	Επαληθεύστε ή περιστρέψτε το κλειδί API.
429	Υπέρβαση του ορίου ποσοστού ή συγχρονισμού	Σεβασμός Retry-After και ξαναπροσπαθήστε με backoff.
5xx	Προσωρινό σφάλμα ανοδικής ροής ή σφάλμα πύλης	Δοκιμάστε ξανά ανεπαρκή αιτήματα με εκθετική υποχώρηση.