Πώς να ενσωματώσετε το OpenAI API στην εφαρμογή σας

Για να ενσωματώσετε το OpenAI API, δημιουργήστε ένα κλειδί API σε ένα project του OpenAI, αποθηκεύστε το ως μυστικό στον server με το όνομα OPENAI_API_KEY και καλέστε το API από μια διαδρομή στον δικό σας server, χρησιμοποιώντας το επίσημο SDK του OpenAI, ποτέ από κώδικα του περιηγητή. Από τον Σεπτέμβριο του 2026, ο οδηγός γρήγορης εκκίνησης του OpenAI παρουσιάζει το Responses API ως αφετηρία για νέα projects. Ορίστε ένα όριο δαπάνης πριν από την κυκλοφορία, περιορίστε το μήκος των απαντήσεων, βάλτε όριο στη συχνότητα που μπορεί να καλεί κάθε χρήστης τη λειτουργία και χειριστείτε τα σφάλματα ορίου ρυθμού με επαναλήψεις.

Αυτός ο οδηγός καλύπτει τη ρύθμιση, τη ροή των αιτημάτων, prompts για έναν AI builder και τα λάθη που διαρρέουν κλειδιά ή κάνουν τα χρήματα να εξαφανίζονται. Οι λεπτομέρειες του OpenAI προέρχονται από την επίσημη τεκμηρίωσή του από τον Σεπτέμβριο του 2026. Για τις γενικές έννοιες (tokens, context windows, τιμολόγηση), διαβάστε πρώτα πώς να χρησιμοποιήσετε LLM APIs.

Τι μπορείτε να φτιάξετε με αυτό

• Έναν βοηθό συνομιλίας μέσα στην εφαρμογή σας (πώς να φτιάξετε μια εφαρμογή AI chatbot)
• Κουμπιά «Σύνοψη αυτού», «Ξαναγράψε αυτό» ή «Σύνταξε απάντηση»
• Εξαγωγή δομημένων δεδομένων από ελεύθερο κείμενο: μετατροπή ενός email σε παραγγελία, σήμανση tickets υποστήριξης
• Αναζήτηση και απαντήσεις ερωτήσεων πάνω στο δικό σας περιεχόμενο
• Δημιουργία εικόνων, ομιλία και άλλες λειτουργίες μέσων, ανάλογα με τα διαθέσιμα μοντέλα

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

Ρύθμιση του λογαριασμού OpenAI

1. Δημιουργήστε λογαριασμό και ένα project στην πλατφόρμα του OpenAI. Οι βέλτιστες πρακτικές παραγωγής του OpenAI συνιστούν ξεχωριστά projects για staging και παραγωγή, ώστε το καθένα να έχει τα δικά του κλειδιά και όρια.
2. Δημιουργήστε ένα κλειδί API project. Το OpenAI συνιστά να ορίζετε ημερομηνία λήξης και να αλλάζετε τα κλειδιά τακτικά.
3. Ορίστε ειδοποιήσεις δαπάνης και σκληρό όριο δαπάνης στη σελίδα ορίων. Ο οδηγός του OpenAI λέει ότι οι ειδοποιήσεις σας ενημερώνουν όταν η χρήση περνά ένα ποσό, και ένα σκληρό όριο επιβάλλει μηνιαίο ανώτατο.
4. Προσθέστε χρέωση. Η τεκμηρίωση των ορίων ρυθμού του OpenAI περιγράφει επίπεδα χρήσης: τα όρια σας αυξάνονται αυτόματα καθώς ξοδεύετε περισσότερα με τον καιρό.

Η ροή του αιτήματος

Περιηγητής  ->  η διαδρομή του server σας  ->  OpenAI API
            <-  (streamed) απάντηση       <-

1. Ο χρήστης κάνει κλικ σε ένα κουμπί ή στέλνει ένα μήνυμα.
2. Ο περιηγητής καλεί τη δική σας διαδρομή, για παράδειγμα POST /api/summarise.
3. Ο server σας ελέγχει ότι ο χρήστης είναι συνδεδεμένος και επιτρέπεται να χρησιμοποιεί τη λειτουργία.
4. Ο server δημιουργεί το αίτημα: οδηγίες, την είσοδο του χρήστη και τυχόν δεδομένα από τη βάση σας που χρειάζεται η εργασία.
5. Καλεί το OpenAI με το κλειδί από το περιβάλλον. Τα SDK του OpenAI διαβάζουν αυτόματα το OPENAI_API_KEY.
6. Στέλνει ή επιστρέφει την απάντηση σε streaming, και καταγράφει τη χρήση tokens.

Τα επίσημα πακέτα SDK του OpenAI ονομάζονται openai και για JavaScript/TypeScript (npm) και για Python (pip).

Επιλογή μοντέλου

Το OpenAI προσφέρει αρκετά μοντέλα σε διαφορετικές τιμές και ταχύτητες, και η γκάμα αλλάζει συχνά. Ξεκινήστε με ένα μικρότερο, φθηνότερο μοντέλο, μετρήστε την ποιότητα σε πραγματικά παραδείγματα και ανεβείτε μόνο αν χρειαστεί. Κρατήστε το όνομα του μοντέλου σε τιμή ρύθμισης ή μυστικό, ώστε να το αλλάζετε χωρίς να ξαναγράψετε κώδικα. Ελέγξτε τη σελίδα τιμολόγησης του OpenAI για τις τρέχουσες τιμές.

Επιλογές και συμβιβασμοί

Prompts για τον AI builder σας

Μια πρώτη λειτουργία:

Πρόσθεσε ένα κουμπί «Σύνοψη» στη σελίδα του ticket. Καλεί μια διαδρομή στον server POST /api/summarise που ελέγχει ότι ο χρήστης είναι συνδεδεμένος, φορτώνει το ticket και καλεί το OpenAI Responses API με το επίσημο SDK openai και το μυστικό OPENAI_API_KEY. Διάβασε το όνομα του μοντέλου από το μυστικό OPENAI_MODEL. Οδηγίες: «Κάνε σύνοψη σε 3 κουκκίδες και μετά πρότεινε μια σύντομη απάντηση. Μην επινοείς αριθμούς παραγγελιών.» Περιόρισε το μήκος εξόδου, κάνε streaming της απάντησης στη σελίδα και μην στέλνεις ποτέ το κλειδί στον περιηγητή.

Κανόνες προστασίας:

Περιόρισε κάθε χρήστη σε 30 αιτήματα AI ανά ώρα, αποθηκευμένα στη βάση δεδομένων. Κατέγραφε τα tokens εισόδου και εξόδου ανά αίτημα, μαζί με το ID χρήστη και το όνομα της λειτουργίας. Αν το OpenAI επιστρέψει 429, σεβάσου την κεφαλίδα Retry-After και επανάλαβε με εκθετική καθυστέρηση και jitter έως 3 φορές· μετά εμφάνισε «Η AI είναι απασχολημένη, δοκίμασε ξανά σε ένα λεπτό.» Εμφάνισε φιλικό μήνυμα σφάλματος για κάθε άλλη αποτυχία και κράτα τη υπόλοιπη σελίδα σε λειτουργία.

Διαχείριση σφαλμάτων και ορίων

Το OpenAI μετρά τα όρια ρυθμού με πολλούς τρόπους, συμπεριλαμβανομένων των αιτημάτων ανά λεπτό και των tokens ανά λεπτό, και φτάνετε όποιο εξαντληθεί πρώτο. Όταν τα ξεπεράσετε, το API επιστρέφει 429 με κεφαλίδα Retry-After. Η τεκμηρίωση του OpenAI λέει να θεωρείτε αυτή την τιμή ως ελάχιστο και να προσθέτετε μια μικρή τυχαία καθυστέρηση, ώστε οι πελάτες να μην επαναλαμβάνουν όλοι μαζί.

Επίσης, προβλέψτε:

• Χρονικά όρια σε μακριές παραγωγές. Το streaming βοηθά, όπως και ένα λογικό όριο εξόδου.
• Διακοπές του παρόχου. Η λειτουργία AI πρέπει να αποτυγχάνει ομαλά χωρίς να χαλάει τη σελίδα.
• Κακή έξοδος. Επικυρώστε τη δομημένη έξοδο πριν την αποθηκεύσετε, και μην αφήνετε την έξοδο του μοντέλου να εκτελεί ευαίσθητες ενέργειες χωρίς έλεγχο στον κώδικά σας.

Συχνά λάθη

• Κλειδί στο frontend ή στο αποθετήριο. Ο κώδικας του περιηγητή είναι δημόσιος, και ένα διαρρεύσαν κλειδί μπορεί να καταχρηστικά μέσα σε λεπτά. Δείτε πώς να διατηρείτε ασφαλή τα κλειδιά API.
• Χωρίς όριο δαπάνης. Ένας βρόχος ή ένας καταχρηστικός χρήστης μπορεί να ανεβάσει μεγάλο λογαριασμό γρήγορα.
• Χωρίς όρια ανά χρήστη. Το όριο του παρόχου προστατεύει το πορτοφόλι σας, όχι τους άλλους χρήστες σας.
• Εμπιστοσύνη στο prompt για την ασφάλεια. Οι χρήστες μπορεί να γράψουν «αγνόησε τις προηγούμενες οδηγίες». Τα δικαιώματα ανήκουν στον κώδικα του server.
• Αποστολή περισσότερων από όσων χρειάζονται. Ολόκληρα έγγραφα και μακριά ιστορικά πολλαπλασιάζουν το κόστος. Στείλτε ό,τι χρειάζεται η εργασία.
• Κωδικοποιημένο όνομα μοντέλου. Τα μοντέλα ενημερώνονται και αποσύρονται· κάντε το ρύθμιση.
• Αποστολή προσωπικών δεδομένων χωρίς σκέψη. Διαβάστε τους όρους χρήσης δεδομένων του OpenAI και στείλτε μόνο ό,τι χρειάζεται η λειτουργία.

Λίστα ελέγχου

• Ξεχωριστά projects (ή κλειδιά) OpenAI για δοκιμές και παραγωγή
• Κλειδί αποθηκευμένο ως μυστικό στον server, ποτέ στον κώδικα του περιηγητή ή στο αποθετήριο
• Ορισμένες ειδοποιήσεις δαπάνης και σκληρό όριο δαπάνης
• Όλες οι κλήσεις περνούν από τον server σας και ελέγχουν τα δικαιώματα του χρήστη
• Περιορισμένο μήκος εξόδου· όνομα μοντέλου ρυθμιζόμενο
• Όριο ρυθμού ανά χρήστη στην εφαρμογή σας
• Χειρισμός 429 με Retry-After, οπισθοχώρηση και jitter
• Φιλική κατάσταση σφάλματος· η σελίδα λειτουργεί χωρίς την AI
• Καταγεγραμμένη χρήση tokens ανά λειτουργία
• Δοκιμασμένο με μακριές, κενές και εχθρικές εισόδους

Χρήση του OpenAI API στο Mythex

Οι λειτουργίες AI στις εφαρμογές που χτίζετε στο Mythex χρησιμοποιούν το δικό σας κλειδί OpenAI, χρεώνεται στον λογαριασμό σας στο OpenAI και όχι στις πιστώσεις χτισίματος του Mythex. Προσθέστε το OPENAI_API_KEY ως μυστικό έργου μέσω του /secrets, των ρυθμίσεων έργου ή της κάρτας μυστικών που εμφανίζει ο agent όταν χρειάζεται κλειδί, και μετά περιγράψτε τη λειτουργία με ένα prompt σαν τα παραπάνω. Μετά την αλλαγή μυστικών σε δημοσιευμένη εφαρμογή, δημοσιεύστε ξανά ώστε να τα πάρει. Η συνταγή της τεκμηρίωσης Προσθήκη λειτουργιών AI με τα δικά σας κλειδιά API έχει ένα αρχικό prompt, και τα Μυστικά στη συνομιλία εξηγούν την κάρτα μυστικών. Συγκρίνετε παρόχους; Δείτε πώς να ενσωματώσετε το Claude API.

Ερωτήσεις