Τεκμηρίωση API: Chat Completions

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

Η βασική διεύθυνση URL είναι https://api.routeria.cc/v1. Δώστε το API key σας στο Authorization header. Τα σφάλματα και οι απορρίψεις είναι δωρεάν, οπότε πληρώνετε μόνο για τα tokens που δημιουργούνται.

• GET /v1/models καταγράφει τα διαθέσιμα μοντέλα.
• POST /v1/chat/completions διαχειρίζεται τη δημιουργία κειμένου.

Η πιστοποίηση είναι αυστηρή. Ένα σφάλμα 401 σημαίνει ότι το κλειδί σας είναι μη έγκυρο ή λείπει. Ένα σφάλμα 402 υποδεικνύει ανεπαρκή προπληρωμένο πιστωτικό. Μπορείτε να κάνετε επαναφόρτωση με USDT (TRC20) ή USDC (Base).

Πρώτη αίτηση με cURL

Στείλτε μια αίτηση POST στο endpoint chat completions. Το model ID είναι uncensored. Είναι ένα μοντέλο ανοιχτού βάρους, βελτιστοποιημένο για απάντηση χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενήλικων.

Πρέπει να ορίσετε το Content-Type header για application/json. Το σώμα της αίτησης περιλαμβάνει το ID του μοντέλου και το πίνακα των μηνυμάτων σας.

Τα σφάλματα δεν καταναλώνουν το πιστωτικό σας υπόλοιπο. Μπορείτε να επαληθεύσετε το κλειδί σας καλώντας πρώτα το endpoint των μοντέλων.

Copycurl https://api.routeria.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how the router handles packet loss"}]
  }'

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

Χρησιμοποιήστε το επίσημο OpenAI Python SDK. Ορίστε το base URL σε https://api.routeria.cc/v1 and provide your API key. The model ID remains uncensored.

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

Υποστηρίζεται streaming μέσω του stream parameter. Λαμβάνετε chunks κειμένου καθώς παράγονται.

Copyfrom openai import OpenAI

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

Node SDK Usage

Ενεργοποιήστε τον πελάτη με τη σωστή βάση URL και API key. Δώστε το model ID uncensored στις κλήσεις ολοκλήρωσης.

Το Node SDK μιμείται την υλοποίηση Python. Μπορείτε να κάνετε streaming απαντήσεων ή να περιμένετε την πλήρη ολοκλήρωση. Η χρήση tokens αναφέρεται στο τελικό chunk.

Βεβαιωθείτε ότι οι μεταβλητές περιβάλλοντος αποθηκεύουν το κλειδί με ασφάλεια. Το API key εμφανίζεται αμέσως κατά την εγγραφή μέσω Google ή email.

Copyimport OpenAI from "openai";

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

Ροή και Χρήση Tokens

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Λαμβάνετε Server-Sent Events (SSE) για κάθε token.

Το τελευταίο chunk περιέχει τα πλήρη στατιστικά χρήσης tokens. Τα input tokens χρεώνονται σε $0.15 ανά 1M tokens. Τα output tokens κοστίζουν $0.50 ανά 1M tokens.

Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση. Μπορείτε να εμφανίζετε κείμενο καθώς φτάνει. Το παράθυρο συνάφειας υποστηρίζει συνολικά 100,000 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)

Function Calling και JSON Mode

Ενεργοποίηση κλήσης λειτουργιών με το tools parameter. Το μοντέλο υποστηρίζει tool_choice για αυστηρό έλεγχο. Χρησιμοποιήστε response_format: {"type": "json_object"} για δομημένη έξοδο.

Αυτό εξασφαλίζει συνεπή ανάλυση στην εφαρμογή σας. Το μοντέλο είναι βελτιστοποιημένο για σαφείς, δομημένες απαντήσεις.

Μπορείτε να συνδυάσετε tools με streaming. Το μοντέλο θα καλέσει συναρτήσεις όταν χρειαστεί. Όλες οι παράμετροι όπως temperature και top_p υποστηρίζονται.

Παράμετροι: Θερμοκρασία, Top-P, Stop

Ρύθμιση temperature για τη δημιουργικότητα. Οι χαμηλότερες τιμές κάνουν τα αποτελέσματα πιο ντετερμινιστικά. top_p ελέγχει τη δειγματοληψία πυρήνα (nucleus sampling). Ορίστε stop ακολουθίες για να διακόψετε τη δημιουργία.

Άλλα υποστηριζόμενα παραμέτρους περιλαμβάνουν seed, presence_penalty, και frequency_penalty. Αυτές επιτρέπουν τον λεπτομερή έλεγχο του στυλ εξόδου.

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

Όρια και Κουotas

Κάθε κλειδί API περιορίζεται σε 300 αιτήσεις ανά λεπτό. Μπορείτε να έχετε 8 ταυτόχρονες αιτήσεις ανά κλειδί. Το μέγεθος του σώματος της αίτησης περιορίζεται στα 8 MB.

Σφάλμα 429 υποδεικνύετε ότι ξεπεράσατε το όριο ταχύτητας. Περιμένετε πριν επαναλάβετε. Κάθε λογαριασμός έχει ένα ενεργό κλειδί· ένα νέο κλειδί αντικαθιστά το παλιό.

Το ID του μοντέλου είναι πάντα uncensored. Δεν είναι GPT, Claude ή κάποιο άλλο μοντέλο παρόχου. Είναι ένα μοντέλο ανοιχτού βάρους που τρέχει στους διακομιστές μας.