Όρια κλειδιών API: IP και Εργαλεία

Κάθε κλειδί API NeuralSpace μπορεί να έχει δύο περιορισμούς: από ποιες διευθύνσεις λειτουργεί και σε ποια εργαλεία παρέχει πρόσβαση. Η ρύθμιση παραμένει στη σελίδα Κλειδιά API, εφαρμόζεται αμέσως μετά την αποθήκευση και ελέγχεται στον διακομιστή πριν από την πρόσβαση στο μοντέλο: ένα απαγορευμένο αίτημα απορρίπτεται με σφάλμα 403, τα διακριτικά δεν χρεώνονται για αυτό.

Γιατί να περιορίσετε το κλειδί

Ένα κλειδί API είναι η πρόσβαση σε μοντέλα επί πληρωμή στο υπόλοιπό σας. Εάν το κλειδί πέσει σε λάθος χέρια, τα αιτήματα άλλων θα δαπανηθούν από τον λογαριασμό σας και θα μπορείτε να το παρατηρήσετε μόνο κοιτάζοντας το ιστορικό χρέωσης. Δύο απλοί περιορισμοί καλύπτουν το πιο συνηθισμένο σενάριο:

• το κλειδί βρίσκεται στον κώδικα ενός bot ή μιας εφαρμογής που εκτελείται από έναν διακομιστή - συνδέστε το κλειδί στη διεύθυνση αυτού του διακομιστή και ένα κλεμμένο αντίγραφο του κλειδιού από το μηχάνημα κάποιου άλλου δεν θα λειτουργήσει.
• το κλειδί εκδίδεται για μια συγκεκριμένη εργασία - αφήστε μόνο τα απαραίτητα εργαλεία, για παράδειγμα συνομιλία και εικόνες, και απενεργοποιήστε το βίντεο, τον ήχο και οτιδήποτε άλλο, ώστε να μην χρησιμοποιούνται "ταυτόχρονα".

Πού να τεθούν περιορισμοί

1. Ανοίξτε τη σελίδα Κλειδιά API.
2. Κάτω από το επιθυμητό κλειδί, κάντε κλικ στο "Περιορισμοί".
3. Συμπληρώστε τη λίστα με τις επιτρεπόμενες διευθύνσεις IP και καταργήστε την επιλογή των πλαισίων που δεν πρέπει να χρησιμοποιεί το κλειδί.
4. Κάντε κλικ στο "Αποθήκευση" - οι περιορισμοί τίθενται σε ισχύ αμέσως.

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

Επιτρεπόμενες διευθύνσεις IP

Στο πεδίο διευθύνσεων, μπορείτε να καθορίσετε μία ή περισσότερες IP - μία ανά γραμμή, έως 50 συνολικά. Ένα κενό πεδίο σημαίνει ότι το κλειδί γίνεται αποδεκτό από οποιαδήποτε διεύθυνση, όπως και πριν: ο περιορισμός ενεργοποιείται μόνο όταν η λίστα είναι πλήρης.

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

Διαθέσιμα εργαλεία

Κάτω από τη λίστα των διευθύνσεων υπάρχει ένα δέντρο εργαλείων. Το ανώτερο επίπεδο είναι πέντε κατηγορίες: LLM (μοντέλα συνομιλίας), Εικόνες, Βίντεο, Ήχος και Άλλα. Η κατάργηση της επιλογής μιας κατηγορίας την απενεργοποιεί εντελώς. Όταν η κατηγορία είναι ενεργοποιημένη, τα πλαίσια ελέγχου στο εσωτερικό λειτουργούν με στοχευμένο τρόπο - μπορείτε να αφήσετε μερικά συγκεκριμένα μοντέλα και να απενεργοποιήσετε τα υπόλοιπα.

Από προεπιλογή, τα πάντα είναι ενεργοποιημένα. Αποθηκεύουμε μόνο αυτά που είναι απενεργοποιημένα, επομένως νέα εργαλεία και μοντέλα που θα έχουμε αργότερα είναι άμεσα διαθέσιμα στο κλειδί - δεν χρειάζεται να τα ενεργοποιήσετε ξεχωριστά.

Τι συμβαίνει σε ένα αίτημα που απορρίφθηκε;

Ένα αίτημα από μια διεύθυνση που δεν έχει επιλυθεί ή σε ένα απενεργοποιημένο εργαλείο λαμβάνει μια απάντηση 403 με μια σαφή περιγραφή του λόγου και αυτό συμβαίνει πριν επικοινωνήσετε με το μοντέλο - τα χρήματα για μια τέτοια κλήση δεν χρεώνονται.

Τα αιτήματα υπηρεσιών - έλεγχος υπολοίπου, λίστα μοντέλων και βοήθεια API - δεν υπόκεινται σε περιορισμούς: παραμένουν διαθέσιμα με οποιοδήποτε κλειδί, έτσι ώστε η εφαρμογή να μπορεί πάντα να ανακαλύπτει το υπόλοιπο και τον κατάλογό της.

Όπου ισχύουν περιορισμοί

Οι βασικοί περιορισμοί τηρούνται σε όλες τις διαδρομές εκτέλεσης: στο δημόσιο API, στον διακομιστή MCP και στις φωνητικές συνδέσεις. Είναι αδύνατο να απαγορεύσετε ξεχωριστά έναν τρόπο λειτουργίας και να επιτρέψετε έναν άλλο - ο έλεγχος πραγματοποιείται στο πραγματικό εργαλείο που εκτελεί την αίτηση.

Ποιος θα ωφεληθεί από αυτό;

Όποιος παίρνει το κλειδί έξω από τον υπολογιστή του: προγραμματιστές ρομπότ και εφαρμογών για κινητές συσκευές, ομάδες με κοινό κλειδί για πολλές υπηρεσίες και εκείνοι που παρέχουν πρόσβαση σε εργολάβους για τη διάρκεια του έργου. Οι περιορισμοί δεν αφορούν τη δυσπιστία, αλλά το γεγονός ότι η διαρροή ενός κλειδιού παύει να είναι ακριβή.

Συχνές ερωτήσεις

Είναι δυνατό να καθοριστεί ένα εύρος διευθύνσεων ή μια μάσκα;

Όχι, αναφέρονται μεμονωμένες διευθύνσεις - έως 50 τεμάχια. Εάν υπάρχουν περισσότερες διευθύνσεις ή αλλάζουν, ελέγξτε την εργασία: συνήθως αρκεί να συνδέσετε το κλειδί σε έναν μόνιμο διακομιστή.

Τι θα συμβεί αν αφήσετε τη λίστα κενή;

Το κλειδί λειτουργεί από οποιαδήποτε διεύθυνση, όπως πριν ορίσετε περιορισμούς. Ο κανόνας ενεργοποιείται μόνο όταν ολοκληρωθεί η λίστα.

Είναι περιορισμένο το υπόλοιπο, η λίστα μοντέλων και η τεκμηρίωση;

Όχι. Αυτά είναι αιτήματα υπηρεσιών, είναι διαθέσιμα με οποιοδήποτε κλειδί - διαφορετικά η εφαρμογή δεν θα μπορούσε να ελέγξει την ισορροπία και να εμφανίσει τα διαθέσιμα μοντέλα.

Πρέπει να ενεργοποιήσω τα νέα μοντέλα με μη αυτόματο τρόπο;

Όχι. Μόνο ό,τι καταργήσατε είναι απενεργοποιημένο. οτιδήποτε άλλο, συμπεριλαμβανομένων των νέων εργαλείων, λειτουργεί αμέσως με το κλειδί.

Μπορούν οι περιορισμοί να αλλάξουν αργότερα;

Ναι, ανά πάσα στιγμή. Ανοίξτε το "Περιορισμοί" δίπλα στο κλειδί, επεξεργαστείτε τη λίστα ή τα πλαίσια ελέγχου και αποθηκεύστε - οι αλλαγές θα ισχύουν για τα επόμενα αιτήματα.