Τεκμηρίωση API

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

Συνδέστε την εφαρμογή σας δείχνοντας προς το αφιερωμένο endpoint μας και περνώντας το μοναδικό API key σας. Το base URL για όλα τα requests είναι https://api.apertusapp.com/v1.Λαμβάνετε το key σας αμέσως μετά την εγγραφή μέσω Google ή email στο Get API key σελίδα. Συμπεριλάβετε αυτό το κλειδί στο Authorization header για κάθε αίτηση.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

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

Πρώτη αίτηση

Στείλτε το πρώτο prompt στο endpoint chat completions για να λάβετε ωμό, ανεξιχνίαστο κείμενο. Χρησιμοποιήστε το ID μοντέλου uncensored για πρόσβαση στο συγκεκριμένο ανοιχτού βάρους μοντέλο, βελτιστοποιημένο για νόμιμη χρήση ενήλικων και αμφιλεγόμενα θέματα.

Copyfrom openai import OpenAI

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

Η API δέχεται τυπικές παραμέτρους όπως temperature και top_p. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν tokens, οπότε πληρώνετε μόνο για αυτό που φτάνει πραγματικά στο μοντέλο. Αυτή η προσέγγιση διατηρεί το κόστος προβλέψιμο σε σύγκριση με aggregators που χρεώνουν για overhead routing.

Node SDK integration

Χρησιμοποιήστε το επίσημο Node SDK για να χειριστείτε αποτελεσματικά τη λειτουργία JSON και την κλήση συναρτήσεων. Ορίστε response_format για {"type": "json_object"} για δομημένες εξόδους ή να ορίσετε εργαλεία για συμπεριφορά τύπου agent.

Copyimport OpenAI from "openai";

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

Το μοντέλο υποστηρίζει κλήσεις εργαλείων με tool_choice επιλογές. Μπορείτε επίσης να ορίσετε ένα seed για ντετερμινιστικά αποτελέσματα. Αυτή η ευελιξία σας επιτρέπει να χτίσετε σύνθετες εφαρμογές χωρίς να φύγετε από το οικοσύστημα OpenAI-compatible.

Απαντήσεις ροής δεδομένων

Ροή tokens σε πραγματικό χρόνο χρησιμοποιώντας 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)

Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για τους τελικούς χρήστες. Μπορείτε να διακόψετε τη ροή αν ο χρήστης αλλάξει γνώμη. Το API χειρίζεται αυτόματα το πρωτόκολλο SSE, απαιτώντας ελάχιστο κώδικα από την πλευρά σας.

Context window και Χωρητικότητα

Το μοντέλο υποστηρίζει παράθυρο πλαισίου 100.000 tokens για την είσοδο και την έξοδο συνολικά. Μπορείτε να ορίσετε έως 16.000 tokens ανά αίτηση, ή να επιστρέψετε στα 2.048 tokens αν παραλείψετε max_tokens.

Αυτό το μεγάλο παράθυρο επιτρέπει εκτεταμένη ανάλυση εγγράφων ή μακροσκελείς ιστορίες συνομιλιών. Ωστόσο, κρατήστε τα σώματα αιτήσεων κάτω από 8 MB. Το μοντέλο δεν είναι GPT ή Llama; είναι ένα διακριτό uncensored AI μοντέλο βελτιστοποιημένο για την συγκεκριμένη περίπτωσή σας.

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

Διαχειριστείτε τυπικά σφάλματα HTTP με επιτυχία για να διατηρήσετε μια ισχυρή ροή εφαρμογής. Ένα 401 σφάλμα υποδεικνύει άκυρο ή λείπον κλειδί API. Ένα 402 σφάλμα σημαίνει ότι το προκαταβλημένο υπόλοιπό σας εξαντλήθηκε. Ένα 429 σφάλμα υποδεικνύει ότι έχετε ξεπεράσει τα 300 αιτήματα ανά λεπτό ή 8 ταυτόχρονες αιτήσεις.

Το υπόλογο δεν λήγει ποτέ, οπότε μπορείτε να διακόψετε τη χρήση και να την ξαναρχίσετε αργότερα. Λάθη όπως οι διπλές χρεώσεις επιδιορθώνονται μέσω της σελίδας Υποστήριξης. Το προκαταβλημένο υπόλοιπο χρεώνεται μόνο για την πραγματική κατανάλωση tokens, εξασφαλίζοντας διαφανή τιμολόγηση για κάθε byte.