SDK compatibility and base URL setup
Συνδέστε τον υπάρχοντα κώδικα πελάτη σας κατευθύνοντάς τον στο αποκλειστικό endpoint μας. Αυτό openai compatible API Αποδέχεται τυπικές κεφαλίδες και ρυθμίσεις SDK χωρίς αλλαγές κώδικα. Χρειάζεται μόνο να ενημερώσετε τη βάση URL και να παρέχετε το API key σας από το dashboard.
https://api.openrouterratelimits.com/v1 είναι το μοναδικό σημείο εισόδου για όλες τις αιτήσεις. Η πιστοποίηση χρησιμοποιεί το τυπικό σχήμα Bearer token που βρίσκεται στις περισσότερες σύγχρονες βιβλιοθήκες LLM. Περνάτε το κλειδί σας στο Authorization header για την επαλήθευση της ταυτότητάς σας. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε client που αναμένει ένα interface τύπου OpenAI, καθιστώντας τη μετοίκιση άμεση για ομάδες που έχουν κουραστεί από το vendor lock-in.
- Base URL:
https://api.openrouterratelimits.com/v1 - Κεφαλίδα Auth:
Authorization: Bearer YOUR_API_KEY - ID Μοντέλου:
uncensored
Ροή αποκρίσεων με SSE
Ενεργοποιήστε streaming ρυθμίζοντας stream: true στο σώμα του αιτήματός σας. Το API επιστρέφει Server-Sent Events (SSE) για παράδοση tokens σε πραγματικό χρόνο. Κάθε κομμάτι περιέχει το παραγόμενο κείμενο μέχρι το τελευταίο κομμάτι να περιλαμβάνει στατιστικά χρήσης. Αυτή η προσέγγιση διατηρεί το UI σας αντιδραστικό ακόμη και για μεγάλα παράθυρα πλαισίου.
Η ροή δεδομένων (streaming) είναι ιδανική για διεπαφές συνομιλίας ή σενάρια roleplay όπου η καθυστέρηση (latency) είναι κρίσιμη. Δεν χρειάζεται να περιμένετε την ολοκλήρωση της απάντησης για να εμφανίσετε το κείμενο. Το τελευταίο κομμάτι περιέχει πάντα τους μετρητές tokens για ακριβή χρέωση. Τα σφάλματα κατά τη ροή δεδομένων επιστρέφουν πάντα τους κατάλληλους κωδικούς κατάστασης HTTP για άμεση διαχείριση.
Κλήση συναρτήσεων και λειτουργία JSON
Χρησιμοποιήστε δομημένες εξόδους για αξιόπιστη εξαγωγή δεδομένων ή ενσωμάτωση εργαλείων. Ενεργοποιήστε response_format με {"type": "json_object"} για να επιβληθεί συμμόρφωση με JSON. Αυτή η λειτουργία είναι απαραίτητη για την ανάλυση πολύπλοκων nested δομών χωρίς επιπλέον λογική καθαρισμού. Η κλήση συναρτήσεων λειτουργεί παράλληλα με την τυπική παραγωγή κειμένου για δυναμικές ροές εργασιών πράκτορων.
Ορίστε τα εργαλεία σας στο tools array και καθορίστε tool_choice για αυστηρή επιβολή. Το μοντέλο επιστρέφει κλήσεις συναρτήσεων στον τυπικό τύπο OpenAI. Αυτή η λειτουργία υποστηρίζει τόσο μεμονωμένες όσο και πολλαπλές κλήσεις εργαλείων εντός μιας μοναδικής στροφής. Χρησιμοποιήστε το για την κατασκευή agents που αλληλεπιδρούν αξιόπιστα με εξωτερικές APIs ή βάσεις δεδομένων.
Managing tokens and parameters
Ελέγξτε τη συμπεριφορά δημιουργίας με τυπικές παραμέτρους όπως temperature, top_p, και stop. Το παράθυρο συνάφειας υποστηρίζει έως 100.000 tokens συνολικά για prompt και completion συνδυαστικά. Αυτό επιτρέπει εκτεταμένο ιστορικό πλαίσιο ή επεξεργασία μεγάλων εγγράφων σε μία μόνο αίτηση.
Ορίστε max_tokens για να περιορίσετε το μήκος της εξόδου, με προεπιλογή 2.048 αν παραληφθεί. Το μοντέλο διαχειρίζεται presence_penalty και frequency_penalty για στυλιστικό έλεγχο. Η χρήση tokens χρεώνεται βάσει των πραγματικών μετρήσεων εισόδου και εξόδου. Τα σφάλματα δεν καταναλώνουν tokens, διασφαλώντας δίκαιη χρέωση για αποτυχημένες αιτήσεις.
Κατανόηση των ορίων ρυθμού ανά κλειδί
Κάθε κλειδί API υποστηρίζει 300 αιτήματα ανά λεπτό με όριο ταυτόχρονης διασύνδεσης 8 ταυτόχρονων αιτήσεων. Αυτό το όριο ισχύει ανά κλειδί, οπότε η δημιουργία πολλαπλών κλειδιών κλιμακώνει τη διαπερατότητά σας γραμμικά. Το μέγιστο μέγεθος του σώματος αιτήματος είναι 8 MB, το οποίο χωράει στο παράθυρο πλαισίου για τις περισσότερες περιπτώσεις χρήσης.
Τα όρια ρυθμού ανανεώνονται συνεχώς βάσει μιας κυλιόμενης παραθύρου. Αν ξεπεράσετε το όριο, το API επιστρέφει σφάλμα 429. Αναβαθμίστε το προπληρωμένο υπόλοιπό σας για να διατηρήσετε την προτεραιότητα. Σε αντίθεση με τα κοινόχρηστα επίπεδα, οι dedicated servers μας δεν υποφέρουν από θόρυβο γειτόνων. Παρακολουθήστε το dashboard χρήσης σας για να μείνετε εντός αυτών των ορίων για συνεπή απόδοση.
Επίλυση προβλημάτων κοινών σφαλμάτων
Διαχειριστείτε τα σφάλματα ελέγχοντας τον κωδικό κατάστασης HTTP και το σώμα της απόκρισης. Το σφάλμα 401 υποδηλώνει μη έγκυρο ή λείπον κλειδί API. Αναγεννήστε το κλειδί σας από το dashboard αν αποτύχει ο έλεγχος ταυτότητας. Το σφάλμα 402 σημαίνει ότι το προκαταβλημένο πιστωτικό σας υπόλοιπο εξαντλήθηκε· συμπληρώστε το μέσω κρυπτονομισμάτων για να συνεχίσετε την υπηρεσία.
Σφάλμα 429 υποδεικνύετε ότι έχετε ξεπεράσει τα όρια ταχύτητας. Μειώστε τη συχνότητα των αιτήσεων ή διαιρέστε τα φορτία εργασίας σε πολλαπλά κλειδιά. Το API δεν χρεώνει tokens για αυτά τα σφάλματα, οπότε δεν χάνετε υπόλοιπο για επαναλήψεις. Βεβαιωθείτε ότι η βιβλιοθήκη client σας χειρίζεται επαναλήψεις με εκθετική backoff για ανθεκτικότητα.
cURL
curl https://api.openrouterratelimits.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Process one million logs"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterratelimits.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterratelimits.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Ροή
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)