OpenRouter API Production Checklist

Verify API Compatibility and Endpoints

Χρησιμοποιήστε τα τυπικά endpoints συμβατά με OpenAI για αξιόπιστη ενσωμάτωση.

Το κύριο τελικό σημείο είναι POST /v1/chat/completions. Αυτό διαχειρίζεται τη δημιουργία κειμένου για ιστορικά συνομιλιών. Μια δευτερεύουσα διεπαφή, GET /v1/models, καταλόγους διαθέσιμων μοντέλων. Δεν χρειάζεστε endpoints ενσωμάτωσης ή δημιουργίας εικόνων για εργασίες μόνο κειμένου. Πολλοί προγραμματιστές υποθέτουν ότι χρειάζονται ένα πολύπλοκο στρώμα διαδρομής. Το OpenRouter απλοποιεί αυτό εκθέτοντας ένα μοναδικό σημείο εισόδου. Στέλνετε ένα payload JSON με το ID του μοντέλου και τα system prompts. Η υπηρεσία επιστρέφει δομημένο JSON με περιεχόμενο και δεδομένα χρήσης. Αυτός ο σχεδιασμός ταιριάζει με τις προσδοκίες του επίσημου OpenAI SDK. Μπορείτε να εναλλάξετε μοντέλα χωρίς να αλλάξετε τον κώδικα του πελάτη σας. Απλώς ενημερώστε το ID μοντέλου στις ρυθμίσεις σας. Βεβαιωθείτε ότι ο πελάτης σας υποστηρίζει το νεότερο JSON schema. Παλαιότερες εκδόσεις μπορεί να απορρίψουν νέες παραμέτρους. Δοκιμάστε τη σύνδεσή σας πριν την ανάπτυξη στην παραγωγή. Επαληθεύστε ότι η μορφή απόκρισης ταιριάζει με τον parser σας.

Ρύθμιση Πιστοποίησης και Κλειδιών

Ασφαλίστε το κλειδί API σας στις μεταβλητές περιβάλλοντος αμέσως μετά τη δημιουργία.

Δημιουργήστε ένα κλειδί μέσω του dashboard του παρόχου. Αποθηκεύστε το σε ασφαλές μέρος. Μην το ενσωματώνετε (hardcode) στο αρχείο πηγαίου κώδικα. Περάστε το μέσω του Authorization: Bearer <key> header. Κάθε κλειδί συνδέεται με έναν συγκεκριμένο λογαριασμό. Μπορείτε να κάνετε rotate τα κλειδιά αν υποψιάζεστε διαρροή. Κάποιοι πάροχοι επιτρέπουν πολλαπλά κλειδιά ανά λογαριασμό. Αυτό σας επιτρέπει να διαχωρίσετε την κίνηση development και production. Παρακολουθήστε τη χρήση ανά κλειδί για να ανιχνεύσετε ανωμαλίες. Ακυρώστε τα κλειδιά που δεν χρησιμοποιούνται τακτικά. Χρησιμοποιήστε κλειδιά μικρής διάρκειας για προσωρινά scripts. Αυτό μειώνει το πεδίο καταστροφής σε περίπτωση διείσδυσης. Βεβαιωθείτε ότι η έκδοση του SDK σας υποστηρίζει πιστοποίηση με Bearer token. Παλαιότερες βιβλιοθήκες μπορεί να απαιτούν διαφορετική μορφή header. Ελέγξτε την τεκμηρίωση για το συγκεκριμένο SDK σας. Βεβαιωθείτε ότι το κλειδί έχει επαρκές υπόλοιπο. Ένα ληγμένο κλειδί επιστρέφει σφάλμα 401. Ένα κλειδί με μηδενικό υπόλοιπο επιστρέφει σφάλμα 402. Διαχωρίστε αυτές τις δύο καταστάσεις στη λογική σας.

Διαχείριση Streaming και Χρήσης Token

Ενεργοποιήστε τη ροή (streaming) για χαμηλότερη καθυστέρηση και ανατροφοδότηση χρήστη σε πραγματικό χρόνο.

Ορίστε stream: true στο σώμα του αιτήματός σας. Ο διακομιστής στέλνει μια σειρά από Server-Sent Events (SSE). Κάθε γεγονός περιέχει ένα μερικό κομμάτι κειμένου. Πρέπει να συναρμολογήσετε αυτά τα κομμάτια για να σχηματίσετε την πλήρη απάντηση. Το τελευταίο κομμάτι συχνά περιλαμβάνει στατιστικά χρήσης tokens. Αυτό σας επιτρέπει να παρακολουθείτε το κόστος σε πραγματικό χρόνο. Χωρίς ροή, περιμένετε για όλη την απάντηση. Αυτό αυξάνει σημαντικά την αντιλαμβανόμενη καθυστέρηση. Η ροή είναι απαραίτητη για διεπαφές συνομιλίας. Δημιουργεί ένα εφέ πληκτρολόγησης που φαίνεται αντιδραστικό. Να είστε προσεκτικοί με τον χειρισμό σφαλμάτων κατά τη ροή. Εάν η σύνδεση διακοπεί, χάνετε το τρέχον κομμάτι. Η λογική επανασύνδεσης πρέπει να διατηρήσει την κατάσταση συνομιλίας. Κάποια SDKs χειρίζονται τη ροή αυτόματα. Άλλα απαιτούν χειροκίνητους ακροατές γεγονότων. Επιλέξτε την προσέγγιση που ταιριάζει στην αρχιτεκτονική σας. Βεβαιωθείτε ότι ο αναλυτής σας χειρίζεται ακέραια κομμάτια JSON. Μην υποθέτετε ότι κάθε γεγονός είναι ένα πλήρες αντικείμενο. Αποθηκεύστε τα δεδομένα μέχρι να έχετε μια έγκυρη δομή.

Παρακολούθηση Ορίων Ρυθμού και Ταυτόχρονης Χρήσης

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

Η OpenRouter επιβάλλει αυστηρά rate limits ανά API key. Η υπέρβαση αυτών των ορίων ενεργοποιεί σφάλμα 429 Too Many Requests. Πρέπει να εφαρμόσετε exponential backoff στη λογική επανάληψής σας. Οι ταυτόχρονες αιτήσεις μετράνε επίσης στα όριά σας. Ελέγξτε τα headers της απόκρισης για το υπόλοιπο quota. Κάποιοι πάροχοι εκθέτουν αυτά τα headers απευθείας. Άλλοι απαιτούν να συμπεράνετε τα όρια από τα σφάλματα. Η υψηλή ταυτόχρονη χρήση μπορεί να εξαντλήσει το connection pool σας. Βεβαιωθείτε ότι ο client σας διαχειρίζεται τις συνδέσεις αποδοτικά. Χρησιμοποιήστε connection pooling για να μειώσετε το overhead. Παρακολουθήστε το βάρος της ουράς σας κατά τις περιόδους αιχμής. Αν χτυπήσετε το όριο, περιμένετε πριν κάνετε retry. Ρανδοποιήστε τον χρόνο αναμονής σας για να αποφύγετε προβλήματα thundering herd. Καταγράψτε όλα τα events rate limit για debugging. Αυτό βοηθά στην αναγνώριση μοτίβων στη χρήση σας. Προσαρμόστε τις ρυθμίσεις concurrency σας βάσει αυτών των logs. Μην υποθέτετε ότι ένα μοναδικό key μπορεί να διαχειριστεί απεριόριστη κίνηση. Κατανείψτε το φορτίο σε πολλαπλά keys αν είναι απαραίτητο. Αυτό απαιτεί προσεκτική διαχείριση κατάστασης. Βεβαιωθείτε ότι κάθε key διατηρεί το δικό του context αν χρειαστεί.

Διαχείριση Πληρωμών Crypto και Προσθέσεων

Χρησιμοποιήστε προπληρωμένο υπόλοιπο για να καλύψετε τη χρήση tokens χωρίς μηνιαίες χρεώσεις.

Χρηματοδοτήστε τον λογαριασμό σας με κρυπτονομίσματα. Τα υποστηριζόμενα δίκτυα περιλαμβάνουν USDT στο TRC20 και USDC στο Base. Οι ελάχιστες καταθέσεις ξεκινούν από $20. Τα bonus εφαρμόζονται για μεγαλύτερα ποσά. Λαμβάνετε 5% επιπλέον για $50, 10% για $100, και 15% για $200. Το υπόχωρο δεν λήγει ποτέ. Αυτό είναι ιδανικό για μακροπρόθεσμα έργα. Πληρώνετε μόνο για τα πραγματικά tokens που χρησιμοποιούνται. Τα σφάλματα και οι απορρίψεις είναι δωρεάν. Αυτό προστατεύει τον προϋπολογισμό σας από απρόβλεπτα κόστη. Οι νέοι λογαριασμοί λαμβάνουν $0.50 για δοκιμές. Δεν εκδίδονται επιστροφές χρημάτων για τυπικές αγορές. Οι διπλές χρεώσεις διορθώνονται μέσω υποστήριξης. Βεβαιωθείτε ότι το πορτοφόλι σας υποστηρίζει τα απαιτούμενα δίκτυα. Επαληθεύστε τη διεύθυνση συμβολαίου πριν στείλετε. Λάθος δίκτυα μπορεί να οδηγήσουν σε απώλεια κεφαλαίων. Ελέγχετε το υπόχωρό σας τακτικά. Τα χαμηλά υπόλοιπα μπορεί να διακόψουν την υπηρεσία απροσδόκητα. Αυτοματοποιήστε τις καταθέσεις αν είναι δυνατόν. Αυτό διασφαλίζει συνεχή διαθεσιμότητα για κρίσιμες εργασίες.

Δοκιμή Φίλτρων Περιεχομένου και Απορρίψεων

Επαληθεύστε ότι το μοντέλο συμπεριφέρεται όπως αναμένεται με uncensored prompts.

Τα μοντέλα χωρίς λογοκρισία ενδέχεται να εφαρμόζουν ακόμη αυστηρά όρια. Ελέγξτε για περιορισμούς σε συγκεκριμένους τύπους περιεχομένου. Δοκιμάστε με γνωστές εκλυτικές φράσεις. Βεβαιωθείτε ότι το μοντέλο ανταποκρίνεται appropriately. Κάποιοι πάροχοι διατηρούν φίλτρα για νομικούς λόγους. Επαληθεύστε τα αυτά πριν βασιστείτε στο μοντέλο για ευαίσθητα δεδομένα. Δοκιμάστε περιπτώσεις ορίων στην περιοχή σας. Στείλτε εντολές που συνήθως προκαλούν απορρίψεις. Παρατηρήστε τη μορφή της απάντησης. Επιστρέφει έναν λόγο απόρριψης; Ή παράγει περιεχόμενο σιωπηλά; Τεκμηριώστε αυτές τις συμπεριφορές στις δοκιμές ενσωμάτωσής σας. Αυτό αποτρέπει εκπλήξεις στην παραγωγή. Εάν το μοντέλο αλλάξει τη συμπεριφορά του, ενημερώστε τις δοκιμές σας. Ειδοποιήστε την ομάδα σας για τυχόν σημαντικές αλλαγές. Η συνέπεια είναι κρίσιμη για την εμπιστοσύνη των χρηστών. Βεβαιωθείτε ότι η εφαρμογή σας διαχειρίζεται τις απορρίψεις με ομαλό τρόπο. Μην υποθέτετε ότι κάθε απάντηση είναι έγκυρη. Επαληθεύστε τη δομή της εξόδου. Ελέγξτε για παραισθήσεις ή σφάλματα μορφοποίησης. Αυτό διασφαλίζει μια αξιόπιστη εμπειρία χρήστη.

Implement Error Handling for Free Requests

Διαχειριστείτε τα σφάλματα με χάρη για να διατηρήσετε μια ομαλή εμπειρία χρήστη.

Μπορούν να εμφανιστούν σφάλματα δικτύου, χρονικοί περιορισμοί και σφάλματα διακομιστή. Εφαρμόστε λογική επαναπροσπάθειας με εκθετική backoff. Διακρίνετε μεταξύ προσωρινών και μόνιμων σφαλμάτων. Ένα σφάλμα 429 είναι προσωρινό. Περιμένετε και επαναπροσπαθήστε. Ένα σφάλμα 400 είναι μόνιμο. Ελέγξτε τα δεδομένα εισόδου σας. Ένα σφάλμα 500 είναι από πλευράς διακομιστή. Επαναπροσπαθήστε με προσοχή. Καταγράψτε όλα τα σφάλματα για debugging. Συμπεριλάβετε το payload της αίτησης και το σώμα της απόκρισης. Αυτό βοηθά στην αναπαραγωγή προβλημάτων γρήγορα. Μην εκθέτετε ωμά σφάλματα στους χρήστες. Μορφοποιήστε τα σε μηνύματα φιλικά προς τον χρήστη. Διαχειριστείτε προσεκτικά τα σφάλματα streaming. Αποσυνδεθείτε από το stream γεγονότων. Καθαρίστε πόρους. Βεβαιωθείτε ότι η εφαρμογή σας δεν διαρρέει μνήμη. Δοκιμάστε σενάρια σφαλμάτων σχολαστικά. Προσομοιώστε αποσυνδέσεις δικτύου. Προσομοιώστε χρονικούς περιορισμούς διακομιστή. Επαληθεύστε ότι η λογική ανάκτησης λειτουργεί. Αυτό διασφαλίζει αξιοπιστία υπό δυσμενείς συνθήκες.

Κλιμακώστε με JSON Mode και Tool Calling

Χρησιμοποιήστε δομημένες εξόδους για αξιόπιστη εξαγωγή δεδομένων και εκτέλεση συναρτήσεων.

Ενεργοποιήστε τη λειτουργία JSON ρυθμίζοντας response_format: {type: "json_object"}. Αυτό αναγκάζει το μοντέλο να εξάγει έγκυρο JSON. Χρησιμοποιήστε το για την ανάλυση δεδομένων ή τη δημιουργία ρυθμίσεων. Η κλήση εργαλείων (tool calling) επιτρέπει στο μοντέλο να εκτελεί συναρτήσεις. Ορίστε τα εργαλεία σας στο φορτίο του αιτήματος. Το μοντέλο αποφασίζει πότε να τα καλέσει. Διαβιβάστε τα αποτελέσματα πίσω στο μοντέλο. Μπορεί να δημιουργήσει μια τελική απάντηση με βάση την έξοδο. Αυτό δημιουργεί έναν βρόχο για πολύπλοκες εργασίες. Βεβαιωθείτε ότι οι ορισμοί των εργαλείων είναι σαφείς. Τα ασαφή εργαλεία οδηγούν σε λανθασμένες κλήσεις. Επαληθεύστε την έξοδο JSON πριν την ανάλυση. Αυτό αποτρέπει σφάλματα χρόνου εκτέλεσης στον κώδικά σας. Χρησιμοποιήστε κλήση εργαλείων για εργασίες εξαγωγής δεδομένων. Βελτιώνει σημαντικά την ακρίβεια. Δοκιμάστε με διάφορες μορφές εισόδου. Βεβαιωθείτε ότι το μοντέλο διαχειρίζεται ακραίες περιπτώσεις. Τεκμηριώστε τα διαθέσιμα εργαλεία για την ομάδα σας. Αυτό εξασφαλίζει συνεπή χρήση σε όλα τα έργα.

Πολιτικές Απορρήτου και Χρήσης Δεδομένων

Κατανοήστε πώς αποθηκεύονται και χρησιμοποιούνται τα δεδομένα σας από τον πάροχο.

Ελέγξτε την πολιτική απορρήτου για λεπτομέρειες διατήρησης δεδομένων. Κάποιοι πάροχοι χρησιμοποιούν τα δεδομένα σας για εκπαίδευση. Άλλοι τα διατηρούν ιδιωτικά. Βεβαιωθείτε ότι τα δεδομένα σας δεν χρησιμοποιούνται για βελτίωση του μοντέλου αν αυτό σας ενδιαφέρει. Επαληθεύστε τα πρότυπα κρυπτογράφησης. Τα δεδομένα πρέπει να είναι κρυπτογραφημένα κατά τη μεταφορά και σε ηρεμία. Ελέγξτε αν αποθηκεύονται αρχεία καταγραφής (logs). Τα logs ενδέχεται να περιέχουν τα prompts σας. Βεβαιωθείτε ότι αυτά τα logs είναι ασφαλή. Αναθεωρήστε τους όρους παροχής υπηρεσιών για ρήτρες ευθύνης. Κατανοήστε ποιος κατέχει τα δικαιώματα στα παραγόμενα περιεχόμενα. Κάποιοι πάροχοι διεκδικούν δικαιώματα στα αποτελέσματά σας. Βεβαιωθείτε ότι αυτό συμφωνεί με τις ανάγκες σας. Διαγράψτε τον λογαριασμό σας αν δεν χρησιμοποιείτε πλέον την υπηρεσία. Επαληθεύστε ότι τα δεδομένα σας έχουν αφαιρεθεί. Επικοινωνήστε με την υποστήριξη αν έχετε απορίες. Τεκμηριώστε τις ρυθμίσεις απορρήτου σας για λόγους ελέγχου. Αυτό διασφαλίζει τη συμμόρφωση με τις εσωτερικές πολιτικές.