OpenRouter api Documentation

Γρήγορη Έναρξη: Σύνδεση με Python

Ξεκινήστε εγκαθιστώντας το επίσημο SDK και κατευθύνοντάς το στη βασική μας διεύθυνση URL.

Η API μας συμπεριφέρεται όπως το τυπικό interface OpenAI αλλά κατευθύνει σε ένα μοναδικό μοντέλο uncensored. Αυτή η προσέγγιση εξαλείφει την πολυπλοκότητα του proxy ενώ διατηρεί τον κώδικά σας φορητό.

• Εγκαταστήστε τη βιβλιοθήκη μέσω pip.
• Ορίστε το API key σας στο περιβάλλον.
• Ορίστε τη base URL για το endpoint μας.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiopenrouter.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)

Αντικαταστήστε το κλειδί placeholder με τα δικά σας διαπιστευτήρια. Μπορείτε να στείλετε απλά prompts ή σύνθετα δομημένα δεδομένα.

Πιστοποίηση και Keys

Δημιουργήστε ένα κλειδί στο dashboard και περάστε το στην κεφαλίδα Authorization.

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

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Η παραπάνω αίτηση χρησιμοποιεί το σχήμα Bearer. Βεβαιωθείτε ότι το κλειδί σας ξεκινά με sk- and contains no extra whitespace.

Τερματικό Συμπληρώματος Συζήτησης

Στείλτε μηνύματα στο /v1/chat/completions σημείο τερματισμού (endpoint) χρησιμοποιώντας τυπικό JSON.

Το μοντέλο δέχεται user και assistant roles. Μπορείτε να ρυθμίσετε temperature, top-p και stop sequences για να ελέγξετε το στυλ εξόδου. Τα responses επιστρέφουν χρήση tokens στο τελευταίο chunk αν το streaming είναι ενεργοποιημένο.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiopenrouter.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);

Ορίστε max_tokens για τον έλεγχο του μήκους εξόδου. Αν παραλειφθεί, η προεπιλογή είναι 2.048 tokens. Το μοντέλο υποστηρίζει έως 16.000 tokens ανά αίτηση.

Streaming Αποκρίσεις

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στο σώμα του αιτήματός σας.

Τα λεπτομερή δεδομένα χρήσης token εμφανίζονται μόνο στο τελευταίο chunk της ροής. Αυτό επιτρέπει ενημερώσεις UI σε πραγματικό χρόνο διατηρώντας ακριβή δεδομένα χρέωσης. Τα σφάλματα κατά τη διάρκεια της ροής αναφέρουν ακόμη χρήση για χρεωμένα tokens.

Copystream = 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)

Διαχειριστείτε τις μερικές απαντήσεις με επιτυχία. Η ροή κλείει φυσιολογικά όταν το μοντέλο ολοκληρώσει τη δημιουργία ή φτάσει στο όριο συμφραζομένων.

Συνάρτηση Calling & JSON Mode

Χρήση response_format: {type: "json_object"} για αυστηρές εξόδους JSON.

Ορίστε εργαλεία στο tools array και ορίστε tool_choice για να επιβάλετε κλήσεις συναρτήσεων. Το μοντέλο επιστρέφει δομημένα δεδομένα κατάλληλα για προγραμματιστική επεξεργασία. Αυτό λειτουργεί αξιόπιστα με τα uncensored βάρη μας.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Συνδυάστε κλήση συναρτήσεων με streaming για διαδραστικές εμπειρίες. Επαληθεύστε την έξοδο JSON πριν την περάσετε στη λογική της εφαρμογής σας.

Όρια και Κουotas

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

Κάθε κλειδί επιτρέπει 300 αιτήματα ανά λεπτό και 8 ταυτόχρονα. Το όριο μεγέθους σώματος αιτήματος είναι 8 MB. Αν ξεπεράσετε τα όρια, η API επιστρέφει κωδικό κατάστασης 429. Τα σφάλματα ελέγχου ταυτότητας επιστρέφουν 401, και η ανεπάρκεια πιστωτικού ισοζυγίου επιστρέφει 402.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Το παράθυρο πλαισίου είναι 100.000 tokens συνολικά. Τα σφάλματα δεν καταναλώνουν πιστωτικό. Οι απορρίψεις για μικρές παραβιάσεις περιεχομένου παραμένουν επίσης δωρεάν.