Ασύγχρονα αιτήματα

Τα ίδια τελικά σημεία συμπεράσματος υποστηρίζουν σύγχρονη και ασύγχρονη εκτέλεση. Προσθέτω "async": true να POST /v1/messages ή POST /v1/chat/completions επί https://api.model-gate.com.

{"model":"claude-sonnet-4.6","messages":[{"role":"user","content":"Analyze this document"}],"async":true}

Η πύλη επιστρέφει 202 Accepted:

{
  "request_id":"01J...",
  "status":"queued",
  "result_url":"https://panel.model-gate.com/api/v1/requests/01J..."
}

Ο request_id είναι το αναγνωριστικό δημόσιου αιτήματος. Επιστρέφεται επίσης μέσα X-Request-ID.

Ανακτήστε το αποτέλεσμα μόνο μέσω του API του πίνακα χρησιμοποιώντας το API KEY σε επίπεδο λογαριασμού από το προφίλ:

curl https://panel.model-gate.com/api/v1/requests/01J... 
  -H "Authorization: Bearer mg_partner_..."

Ένα αίτημα σε ουρά ή σε επεξεργασία επιστρέφει την τρέχουσα κατάστασή του. Επιστρέφει ένα ολοκληρωμένο αίτημα response_status, response_headers, και response. Ένα αποτυχημένο αίτημα επιστρέφει επίσης ένα error αντικείμενο. Επιστρέφουν όλα άγνωστα, ξένα και ληγμένα αναγνωριστικά αιτημάτων 404.

Το κλειδί API μοντέλου που χρησιμοποιείται για συμπέρασμα δεν μπορεί να ανακτήσει ασύγχρονα αποτελέσματα. Το API KEY σε επίπεδο λογαριασμού δεν μπορεί να καλέσει μοντέλα.

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

Προειδοποίηση αποθήκευσης: το αίτημα και η απάντηση αποθηκεύονται προσωρινά στη βάση δεδομένων Model Gate. Οι μη συγχρονισμένες εγγραφές διαγράφονται μετά από 24 ώρες. Μην χρησιμοποιείτε τη λειτουργία ασύγχρονης λειτουργίας για δεδομένα που δεν πρέπει να αποθηκευτούν προσωρινά.

Χρήση υπογραφών επανάκλησης X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, υπογράφοντας την ακριβή συμβολοσειρά <timestamp>.<raw_body> με το μυστικό επανάκλησης από το προφίλ.

Επανακλήσεις

Τα ολοκληρωμένα αποτελέσματα ασυγχρονισμού μπορούν να παραδοθούν στη διεύθυνση URL επανάκλησης που έχει διαμορφωθεί στο Προφίλ. Βλέπω Επανακλήσεις για την επαλήθευση υπογραφής, τις επαναλήψεις, την ασφάλεια και την καθοδήγηση αδυναμίας.