Τεκμηρίωση API

Βασικό URL και Αυθεντικοποίηση

Το endpoint της API βρίσκεται στο https://api.openrouteraiapi.com/v1. Δώστε το API key σας στο Authorization header ως bearer token. Αυτό το header είναι η μόνη αλλαγή που χρειάζεται για να κατευθύνετε την κίνηση από τον τρέχοντα πάροδό σας στο μοντέλο μας uncensored.

Η πιστοποίηση είναι αυστηρή. Αν λείπει το κλειδί ή είναι μη έγκυρο, ο διακομιστής επιστρέφει αμέσως σφάλμα 401. Μπορείτε να δημιουργήσετε κλειδί ακαριαία μέσω Google ή email στο ταμπλό. Κρατήστε το κλειδί ασφαλές, καθώς παρέχει πρόσβαση στο προπληρωμένο πιστωτικό σας.

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

Στείλτε αιτήματα POST στο /v1/chat/completions με ένα array messages. Το model identifier είναι uncensored.Αυτό το μοναδικό μοντέλο διαχειρίζεται όλες τις ανάγκες δημιουργίας κειμένου σας χωρίς πολύπλοκη λογική δρομολόγησης.

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

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

Η απάντηση περιλαμβάνει το παραγόμενο κείμενο στο choices[0].message.content πεδίο. Μπορείτε να αναλύσετε αυτό απευθείας στη ροή εργασίας της εφαρμογής σας.

Ενσωμάτωση SDK Python

Χρησιμοποιήστε το επίσημο OpenAI Python client για να συνδεθείτε χωρίς κόπο. Ορίστε το base_url και api_key variables για να κατευθύνετε στην υποδομή μας. Αυτή η προσέγγιση ελαχιστοποιεί τις αλλαγές κώδικα όταν αλλάζετε παρόχους.

Copyfrom openai import OpenAI

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

Ο client χειρίζεται αυτόματα τη serialization και τα retries. Λαμβάνετε ένα completion object που περιέχει το κείμενο και τα token usage statistics. Αυτή η μέθοδος είναι ιδανική για backend services και scripts.

Χρήση SDK Node.js

Αρχικοποιήστε τον πελάτη OpenAI Node.js με τη βάση URL. Αυτό επιτρέπει στις εφαρμογές JavaScript να αλληλεπιδράσουν με το μοντέλο uncensored χρησιμοποιώντας γνωστές μεθόδους. Το SDK διαχειρίζεται αποτελεσματικά τις κλήσεις HTTP.

Copyimport OpenAI from "openai";

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

Κλήση chat.completions.create() με τα μηνύματά σας. Το αντικείμενο απόκρισης παρέχει πρόσβαση στο παραγόμενο περιεχόμενο και δεδομένα χρήσης. Αυτή η ενσωμάτωση λειτουργεί καλά για web servers και edge functions.

Streaming Αποκρίσεις

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Ο διακομιστής επιστρέφει Server-Sent Events (SSE) για παράδοση 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)

Κάθε chunk περιέχει μερικό περιεχόμενο. Το τελικό chunk περιλαμβάνει τα πλήρη στατιστικά χρήσης tokens. Διαχειριστείτε αυτά τα events στον πελάτη σας για να ενημερώνετε το UI σταδιακά.

Όρια, Σφάλματα και Context Window

Το παράθυρο πλαισίου υποστηρίζει 100,000 tokens για συνδυασμένη είσοδο και έξοδο. Κάθε αίτημα μπορεί να εξάγει έως 16,000 tokens, ή 2,048 αν max_tokens είναι μη ρυθμισμένο. Τα όρια ρυθμού επιτρέπουν 300 αιτήσεις ανά λεπτό ανά κλειδί.

Τα σφάλματα είναι τυπικοί κωδικοί HTTP. Το 401 υποδεικνύει μη έγκυρο κλειδί. Το 402 σημαίνει ότι το προκαταβλεπόμενο πιστωτικό σας εξαντλήθηκε. Το 429 σηματοδοτεί ότι έχετε ξεπεράσει το όριο ρυθμού. Οι αιτήσεις που αποτυγχάνουν δεν καταναλώνουν πιστωτικό. Τα σφάλματα είναι δωρεάν.