POST /v1/chat/completions

Αίτηση

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [
      {"role": "user", "content": "Explain this API in one sentence."}
    ],
    "stream": false
  }'

Ο model μπορεί να είναι ένα κανονικό αναγνωριστικό ή ένα ενεργοποιημένο ψευδώνυμο. Το Model Gate επιλύει ψευδώνυμα πριν από την τιμολόγηση και στέλνει το κανονικό αναγνωριστικό ανάντη.

Απάντηση

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "claude-opus-4.7",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "Model Gate provides one compatible API for multiple AI models."},
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 17,
    "total_tokens": 31
  }
}

Αίτημα ροής

Σειρά "stream": true. Τα ανοδικά συμβάντα που απεστάλησαν από διακομιστή διαβιβάζονται χωρίς να ξαναγραφούν τα επιτυχημένα ωφέλιμα φορτία συμβάντων.

Ασύγχρονο αίτημα

Για υποστηριζόμενα τελικά σημεία, προσθέστε "async": true με "stream": false. Η άμεση απάντηση είναι HTTP 202 και περιέχει request_id και μια διεύθυνση URL αποτελέσματος Partner API.

Σφάλματα

Η κατάσταση, το σώμα και ο τύπος περιεχομένου του παρόχου που δεν είναι 2xx μεταβιβάζονται αμετάβλητα. Τα τοπικά δημιουργημένα σφάλματα επικύρωσης χρησιμοποιούν τον φάκελο σφαλμάτων Model Gate.

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