Οδηγός Ενσωμάτωσης

Γρήγορη Έναρξη: Το πρώτο σας request

Η API είναι μια συμβατή με openai API που μιμείται τη δομή Chat Completions. Στέλνετε κείμενο, λαμβάνετε κείμενο. Χωρίς επιπλέον endpoints για embeddings ή ήχο που θα μπερδεύουν τη ροή εργασίας σας. Ξεκινήστε κατευθύνοντας τον πελάτη σας στη βάση URL μας.

• Base URL: HTTPS://api.filtrosemia.com/v1
• ID Μοντέλου: "uncensored"

Αντικαταστήστε τη υπάρχουσα βάση URL στη διαμόρφωση του SDK σας. Το endpoint χειρίζεται τα πάντα, από roleplay έως μετάφραση, χωρίς τους συνηθισμένους φilters.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

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

Περνάτε το API key σας στην τυπική κεφαλίδα Authorization. Χρησιμοποιούμε ένα μοναδικό ενεργό κλειδί ανά λογαριασμό για απλότητα. Αν χρειαστείτε ένα νέο, δημιουργήστε το από το dashboard σας.

• Header: Authorization: Bearer YOUR_API_KEY
• Χωρίς Ροές OAuth ή refresh tokens για διαχείριση.

Κρατήστε το κλειδί σας ασφαλές. Παρέχει άμεση πρόσβαση στα προκαταβλημένα credits σας. Σφάλματα όπως 401 Unauthorized mean the key is missing or invalid.

Copyfrom openai import OpenAI

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

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

Στείλτε μηνύματα στο POST /v1/chat/completions. Το μοντέλο υποστηρίζει τυπικές παραμέτρους όπως temperature, top_p, και stop ακολουθίες. Είναι ένα μοντέλο uncensored ρυθμισμένο για περιεχόμενο ενηλίκων και δημιουργικό περιεχόμενο.

• Υποστηρίζει json_object format response.
• Αποδέχεται ορισμούς εργαλείων για function calling.

Οι αιτήσεις επεξεργάζονται διαδοχικά εντός των ορίων ρυθμού σας. Βεβαιωθείτε ότι το payload σας παραμένει κάτω από 8 MB.

Copyimport OpenAI from "openai";

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

Streaming Αποκρίσεις (SSE)

Χρησιμοποιήστε Server-Sent Events για παράδοση tokens σε πραγματικό χρόνο. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές εξόδους. Το τελευταίο chunk περιέχει τα πλήρη στατιστικά χρήσης tokens.

• Ορίστε stream: true στο αίτημά σας.
• Επεξεργαστείτε τη ροή SSE στον πελάτη σας.

Το streaming λειτουργεί ταυτόσημα με τη συμπεριφορά του τυπικού SDK της OpenAI. Διαχειρίζεστε τα chunks καθώς φτάνουν.

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)

Παράθυρο Συμφραζομένων και Όρια

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

• Προεπιλεγμένη μέγιστη έξοδος: 2,048 tokens.
• Περιορισμός ρυθμού: 300 αιτήματα ανά λεπτό.

Η υπέρβαση ορίων προκαλεί 429 Too Many Requests σφάλμα. Προσαρμόστε τη ταυτόχρονη χρήση για να μείνετε εντός ορίων. Επιτρέπονται 8 ταυτόχρονες αιτήσεις ανά κλειδί.

Χειρισμός Σφαλμάτων και Tokens

Διαχειριστείτε τυπικά σφάλματα HTTP. 402 Payment Required means your prepaid credit is exhausted. 429 υποδεικνύει περιορισμό ρυθμού. 401 σήματα προβλήματα ελέγχου ταυτότητας.

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

Ελέγξτε το σώμα της απόκρισης για λεπτομερή μηνύματα σφάλματος. Χρησιμοποιήστε τα για να προσαρμόσετε τη λογική επανάληψης ή τη συχνότητα пополнения πιστωτικού.