χρησιμοποιώντας το λανθασμένο base_url
Η χρήση της τυπικής διεύθυνσης base URL της OpenAI προκαλεί αποτυχία των αιτημάτων σας ή διαδρομή προς ένα διαφορετικό μοντέλο εξ ολοκλήρου. Η API μας απαιτεί να αλλάξετε το base_url για https://api.whatisopenrouterai.com/v1.Αυτή η μοναδική γραμμή διαμόρφωσης διασφαλίζει ότι το SDK σας συνδέεται στους διακομιστές μας αντί για την παγκόσμια υποδομή OpenAI.
Πολλοί προγραμματιστές αντιγράφουν-επικολλούν τον υπάρχοντα κώδικά τους χωρίς να ενημερώνουν αυτή τη μεταβλητή. Αν αφήσετε τη default URL, είτε θα λάβετε σφάλμα 404 είτε θα χτυπήσετε ένα μοντέλο που δεν είναι uncensored. Επαληθεύστε πάντα τη σύνδεση ελέγχοντας το /v1/models endpoint. Θα δείτε το συγκεκριμένο ID μοντέλου μας να αναγράφεται εκεί. Αυτό επιβεβαιώνει ότι η διαδρομή είναι σωστή πριν στείλετε την πρώτη αίτηση συμπλήρωσης.
ξεχνώντας να ορίσετε το model id
Ακόμη και με τη σωστή βάση URL, η παράλειψη του ID μοντέλου οδηγεί σε ένα γενικό ή παλαιότερο μοντέλο. Πρέπει να ορίσετε ρητά το model η παράμετρος σε "uncensored" σε κάθε αίτημα. Αυτό λέει στο layer διακίνησης να εξυπηρετήσει το συγκεκριμένο open-weight model που έχει βελτιστοποιηθεί για unrestricted content.
Χωρίς αυτή την ρητή οδηγία, μπορεί να λάβετε ένα διαφορετικό μοντέλο με διαφορετικούς κανόνες ευθυγράμμισης. Κάποια μοντέλα απορρίπτουν νόμιμα θέματα ενηλίκων εξ ορισμού. Αναγκάζοντας την uncensored ID, εγγυάστε τη συμπεριφορά που αναμένετε. Ελέγξτε τον κώδικά σας για τυχόν hardcoded ονόματα μοντέλων που μπορεί να υπεργράψουν τις προεπιλογές του SDK σας.
ignoring token limits and errors
Η υπέρβαση του παραθύρου συνάφειας 100,000 tokens ή του ορίου εξόδου 16,000 tokens προκαλεί άμεση αποτυχία αιτημάτων. Η API μας επιβάλλει μέγιστη έξοδο 16,000 tokens ανά αίτημα. Αν δεν ορίσετε max_tokens, η προεπιλογή είναι μόνο 2.048 tokens. Αυτό είναι συχνά πολύ μικρό για εργασίες σύνθετης λογικής.
Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν το προκαταβλημένο πιστωτικό σας υπόλοιπο. Ωστόσο, λανθασμένα διαμορφωμένες αιτήσεις που χτυπούν όρια ρυθμού ή υπερβαίνουν το μέγεθος σώματος (8 MB) μετράνε ακόμα κατά του ορίου σας. Παρακολουθήστε τις κεφαλίδες απόκρισης για χρήση tokens. Προσαρμόστε την μηχανική prompts σας για να χωρέσετε στο παράθυρο συμφραζομένων. Αυτό αποτρέπει ακριβές επαναλήψεις και διασφαλίζει ομαλή ροή δεδομένων.
κατάνοηση της προκαταβολικής χρέωσης
Το υπόλοιπο του λογαριασμού σας συνδέεται με προκαταβλημένο πιστωτικό υπόλοιπο, όχι με μηνιαία συνδρομή. Χρεώνουμε $0.15 ανά 1M input tokens και $0.50 ανά 1M output tokens. Τα σφάλματα είναι δωρεάν, αλλά οι επιτυχείς ολοκληρώσεις καταναλώνουν πιστωτικό υπόλοιπο. Πρέπει να συμπληρώσετε μέσω κρυπτονομισμάτων για να διατηρήσετε τη διαθεσιμότητα της υπηρεσίας.
Δεχόμαστε USDT (TRC20) ή USDC (Base) για пополнения. Οι ελάχιστες καταθέσεις ξεκινούν από $20. Τα bonuses εφαρμόζονται σε υψηλότερα tiers: +5% από $50, +10% από $100, και +15% από $200. Το credit δεν λήγει ποτέ. Βεβαιωθείτε ότι το υπόλοιπό σας είναι θετικό πριν τρέξετε μεγάλα batches. Ελέγξτε το dashboard για να επαληθεύσετε το τρέχον υπόλοιπο και τις πρόσφατες συναλλαγές.
confusing streaming with standard responses
Η ροή μέσω SSE αλλάζει τον τρόπο με τον οποίο επεξεργάζεστε τη ροή απάντησης. Οι τυπικές απαντήσεις επιστρέφουν ένα μοναδικό JSON object. Η ροή επιστρέφει πολλαπλά chunks. Πρέπει να χειριστείτε το τελικό chunk για να λάβετε ακριβή στατιστικά χρήσης tokens.
Η υλοποίηση streaming μας περιλαμβάνει τη χρήση tokens στο τελευταίο chunk. Αν διακόψετε την ανάγνωση του stream νωρίτερα, ενδέχεται να χάσετε αυτά τα δεδομένα. Βεβαιωθείτε ότι η βιβλιοθήκη πελάτη σας υποστηρίζει σωστά το SSE. Αυτό είναι κρίσιμο για εφαρμογές πραγματικού χρόνου όπου εμφανίζετε tokens καθώς παράγονται. Η λανθασμένη διαμόρφωση streaming μπορεί να οδηγήσει σε ακατέργαστο κείμενο ή καταστάσεις UI που σπάνε.
σφάλματα διαμόρφωσης επιλογής εργαλείου
Λάθος tool_choice ρυθμίσεις μπορεί να εμποδίσουν το function calling να λειτουργεί όπως αναμένεται. Μπορείτε να αναγκάσετε ένα συγκεκριμένο εργαλείο ή να αφήσετε το μοντέλο να αποφασίσει. Η λανθασμένη διαμόρφωση συχνά οδηγεί το μοντέλο να αγνοεί τις διαθέσιμες συναρτήσεις.
Χρήση tool_choice για να ελέγξετε αν το μοντέλο καλεί εργαλεία αυτόματα. Ορίστε το σε "auto" για ευελιξία ή καθορίστε ένα ID εργαλείου για αυστηρή συμπεριφορά. Βεβαιωθείτε ότι οι ορισμοί λειτουργιών σας ταιριάζουν με το αναμενόμενο schema. Αυτό αποφεύγει σφάλματα χρόνου εκτέλεσης όταν το μοντέλο προσπαθεί να καλέσει μια μη υπάρχουσα λειτουργία. Δοκιμάστε τους ορισμούς εργαλείων σας σχολαστικά πριν την ανάπτυξη στην παραγωγή.
λειτουργία missing json_object
Χωρίς response_format: {"type": "json_object"}, το μοντέλο μπορεί να εξάγει markdown ή απλό κείμενο. Αυτό διαταράσσει parsers που αναμένουν αυστηρό JSON. Ενεργοποιήστε τη λειτουργία JSON για να διασφαλίσετε συνεπή, αναγνώσιμο εξόδου.
Αυτή η λειτουργία είναι απαραίτητη για την ενσωμάτωση με downstream συστήματα που απαιτούν δομημένα δεδομένα. Μειώνει σημαντικά το κόστος μετα-επεξεργασίας. Επαληθεύστε πάντα το schema εξόδου στον κώδικα του client σας. Αυτό εξασφαλίζει ανθεκτικότητα σε περιστασιακές αλλοιώσεις (hallucinations) του μοντέλου. Χρησιμοποιήστε αυτή τη λειτουργία όταν εξάγετε οντότητες ή δημιουργείτε αρχεία διαμόρφωσης.
rate limit surprises
Η API μας επιτρέπει 300 αιτήματα ανά λεπτό ανά κλειδί. Η υπέρβαση αυτού του ορίου οδηγεί σε απόκριση 429 Too Many Errors. Οι ταυτόχρονες αιτήσεις περιορίζονται σε 8 ανά κλειδί. Ρυθμίστε τις ρυθμίσεις ταυτόχρονης εκτέλεσης ανάλογα.
Αν εκτελέσετε πολλαπλές διεργασίες, βεβαιωθείτε ότι μοιράζονται το ίδιο key ή δημιουργήστε ξεχωριστά keys. Κάθε λογαριασμός υποστηρίζει ένα ενεργό key. Ένα νέο key αντικαθιστά το παλιό. Παρακολουθήστε τα headers ορίων ρυθμού στις αποκρίσεις. Υλοποιήστε εκθετική επαναπροσπάθεια στη λογική επανάληψής σας. Αυτό αποτρέπει τις καταρρεύσεις αλυσίδας κατά περιόδους υψηλής κίνησης.
καθυστερήσεις επαναφόρτωσης κρυπτονομισμάτων
Οι συναλλαγές κρυπτονομισμάτων μπορεί να χρειαστούν χρόνο για επιβεβαίωση στο blockchain. Το υπόλοιπό σας ενδέχεται να μην εμφανιστεί άμεσα μετά την αποστολή κεφαλαίων. Χρησιμοποιήστε το σωστό δίκτυο: TRC20 για USDT ή Base για USDC. Η αποστολή στο λάθος δίκτυο προκαλεί απώλεια κεφαλαίων.
Τα ποσά συμπλήρωσης κυμαίνονται από $20 έως $500. Βεβαιωθείτε ότι στέλνετε το ακριβές ποσό ή λάβετε υπόψη τα κόστη δικτύου. Ελέγξτε το hash της συναλλαγής στον blockchain explorer. Αν το πιστωτικό υπόλοιπο καθυστερήσει, επικοινωνήστε με την υποστήριξη με το ID της συναλλαγής. Μην υποθέτετε ότι η πληρωμή απέτυχε αμέσως. Η υπομονή κατά τη διάρκεια της συμφόρησης του δικτύου είναι το κλειδί για ομαλή λειτουργία.
