Τεκμηρίωση API & Γρήγορη Έναρξη

Πιστοποίηση & Base URL

Ξεκινήστε δημιουργώντας το κλειδί API σας στον πίνακα ελέγχου. Χρησιμοποιούμε τυπικές κεφαλίδες συμβατές με OpenAI, οπότε χρειάζεται μόνο να ενημερώσετε το base_url και API_KEY μεταβλητές. Αυτό διασφαλίζει ότι οι υπάρχουσες ενσωματώσεις SDK σας λειτουργούν χωρίς τροποποιήσεις. Υποστηρίζουμε εγγραφή μέσω Google Sign-In ή email/κωδικός, και το κλειδί API εμφανίζεται αμέσως μετά τη δημιουργία του.

• Base URL: https://api.routeropen.cc/v1
• Κεφαλίδα Auth: Authorization: Bearer YOUR_API_KEY

Κρατήστε το κλειδί σας ασφαλές, καθώς ελέγχει το προκαταβλημένο credit σας. Κάθε λογαριασμός επιτρέπει ένα ενεργό κλειδί τη φορά· η δημιουργία ενός νέου αντικαθιστά το παλιό αμέσως.

Πρώτη αίτηση

Στείλτε το πρώτο prompt χρησιμοποιώντας το τυπικό chat/completions endpoint. Το model ID είναι απλώς uncensored. Αυτό στέλνει κείμενο προς τα μέσα και επιστρέφει κείμενο προς τα έξω, χωρίς φιλτραρίσματα περιεχομένου για νόμιμη χρήση ενήλικων.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

Αυτό το αίτημα απεικονίζει τη βασική δομή. Μπορείτε να προσαρμόσετε παραμέτρους όπως temperature ή top_p για τον έλεγχο της δημιουργικότητας. Η απάντηση περιλαμβάνει στατιστικά χρήσης tokens για διαφανή τιμολόγηση.

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

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για να ενσωματώσετε το API. Κατευθύνετε τον πελάτη στη βάση URL μας και χρησιμοποιήστε το API key σας. Αυτή η προσέγγιση λειτουργεί ομαλά με υπάρχοντα repos κώδικα που στοχεύουν ήδη στην OpenAI.

Copyfrom openai import OpenAI

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

Η βιβλιοθήκη χειρίζεται αυτόματα τη σειριοποίηση JSON και τη ροή δεδομένων. Μπορείτε να ρυθμίσετε λογική επαναπροσπάθειας και timeouts ανάλογα με τις ανάγκες σας. Το endpoint μας υποστηρίζει τυπικές παραμέτρους, καθιστώντας τη μετοίκιση από άλλους παρόχους αμελητέα.

Node SDK Integration

Για προγραμματιστές JavaScript, το Node SDK λειτουργεί με ελάχιστες αλλαγές. Ορίστε το baseURL στο endpoint και παρέχετε το key σας. Αυτό σας επιτρέπει να διατηρήσετε το τρέχον workflow ανάπτυξης ενώ έχετε πρόσβαση σε μοντέλα uncensored.

Copyimport OpenAI from "openai";

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

Node users can leverage async/await patterns for clean code. The response structure matches OpenAI standards, ensuring compatibility with existing parsers. You can switch models or providers by changing just two variables.

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 περιέχει τη συνολική χρήση tokens για χρέωση. Το streaming λειτουργεί με όλες τις παραμέτρους, συμπεριλαμβανομένου του function calling. Χρησιμοποιήστε το για διεπαφές chat όπου η άμεση ανατροφοδότηση είναι κρίσιμη. Τα σφάλματα επιστρέφονται ακόμη ως events SSE, οπότε μπορείτε να διαχειριστείτε αποτυχίες με χάρη.

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

Η API μας επιβάλλει ένα context window 100,000 tokens και ένα όριο σώματος αίτησης 8MB. Μπορείτε να κάνετε 300 αιτήσεις ανά λεπτό ανά κλειδί. Αν το υπερβείτε, λαμβάνετε σφάλμα ορίου ρυθμού 429. Οι αποτυχίες αυθεντικοποίησης επιστρέφουν 401 και τα ανεπαρκή πιστωτικά υπολοίπα επιστρέφουν 402.

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