Τεκμηρίωση API

Γρήγορη Έναρξη: Σύνδεση του Πρώτου Σας Αιτήματος

Ξεκινήστε δημιουργώντας το κλειδί σας στον πίνακα ελέγχου. Η βασική διεύθυνση URL για όλες τις αιτήσεις είναι HTTPS://api.filterno.cc/v1. Δώστε το κλειδί σας στην κεφαλίδα Authorization ως bearer token. Αυτή η ρύθμιση λειτουργεί με οποιονδήποτε τυπικό πελάτη συμβατό με OpenAI.

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

Αντικαταστήστε το YOUR_API_KEY με το string που εκδόθηκε στον λογαριασμό σας. Το body του αιτήματος ορίζει το μοντέλο και το περιεχόμενο του μηνύματος. Λαμβάνετε μια απόκριση που περιέχει το παραγόμενο κείμενο.

Τερματικό σημείο: POST /v1/chat/completions

Στείλτε τα prompts σας στο POST /v1/chat/completions. Αυτό είναι το μόνο endpoint συνομιλίας που υποστηρίζουμε. Παρέχετε μια οδηγία συστήματος και μηνύματα χρήστη σε μορφή array.

Ο αναγνωριστικός κώδικας του μοντέλου είναι "uncensored". Επεξεργάζεται κείμενο εισόδου και επιστρέφει κείμενο εξόδου. Μην περιμένετε παραγωγή εικόνων ή ήχου εδώ.

Ορίστε τη θερμοκρασία για να ελέγξετε την τυχαιότητα. Οι υψηλότερες τιμές παράγουν πιο δημιουργικά αποτελέσματα. Οι χαμηλότερες τιμές δίνουν ντετερμινιστικά αποτελέσματα. Το API ακολουθεί αυστηρά το schema OpenAI για αυτή την ενότητα.

Τερματικό σημείο: GET /v1/models

Επαληθεύστε τα διαθέσιμα μοντέλα με ένα αίτημα GET στο /v1/models. Αυτό το endpoint επιστρέφει μια λίστα των υποστηριζόμενων IDs μοντέλων. Θα πρέπει να δείτε "uncensored" στην απόκριση.

Αυτό το endpoint επιβεβαιώνει ότι το API key σας είναι έγκυρο. Επίσης δείχνει τις λεπτομέρειες του μοντέλου. Χρησιμοποιήστε το για debugging προβλημάτων σύνδεσης.

Η απάντηση περιλαμβάνει το ID του μοντέλου και τον τύπο αντικειμένου. Δεν αναφέρει τιμολόγια ή όρια. Ελέγξτε την τεκμηρίωση για τους ρυθμούς tokens.

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

Ελέγξτε τη ποικιλία δημιουργίας με temperature και top_p. Το temperature προσαρμόζει την κατανομή πιθανοτήτων. Το top_p φιλτράρει tokens χαμηλής πιθανότητας. Μαζί ισορροπούν τη δημιουργικότητα και την εστίαση.

Χρησιμοποιήστε κλήση συναρτήσεων για δομημένες αλληλεπιδράσεις. Ορίστε τα εργαλεία στο σώμα της αίτησης. Το μοντέλο μπορεί να καλέσει αυτές τις συναρτήσεις. Δώστε tool_choice για να επιβάλετε συγκεκριμένη συμπεριφορά.

Ορίστε ακολουθίες stop για τερματισμό νωρίς της δημιουργίας. Χρησιμοποιήστε seed για αναπαραγώγιμα αποτελέσματα. Τα penalties παρουσίας και συχνότητας μειώνουν την επανάληψη. Αυτές οι παράμετροι ακολουθούν τις τυπικές συμβάσεις OpenAI.

Streaming Αποκρίσεις (SSE) & Χρήση Token

Ενεργοποιήστε τη ροή (streaming) ορίζοντας stream σε true. Η API επιστρέφει Server-Sent Events (SSE). Κάθε chunk περιέχει μερικά δεδομένα tokens.

Η χρήση token εμφανίζεται στο τελευταίο chunk. Διαβάστε το για να παρακολουθήσετε το κόστος. Η ροή (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροσκελείς απαντήσεις. Είναι ιδανική για εφαρμογές πραγματικού χρόνου.

Ανάλυση της δομής δεδομένων SSE προσεκτικά. Διαχειριστείτε διακοπές δικτύου με χάρη. Το API διασφαλίζει ακεραιότητα δεδομένων μέσω ορίων chunk.

Όρια, Σφάλματα και Αριθμητική Tokens

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

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

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

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Ροή

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)