Γρήγορη Έναρξη: Ενσωματώστε το apertus ai chat

Προαπαιτούμενα και Ρύθμιση

Ξεκινήστε δημιουργώντας έναν λογαριασμό και αποκτώντας το API key σας. Εγγραφείτε χρησιμοποιώντας Google ή email password στη σελίδα δημιουργίας κλειδιού. Το σύστημα εμφανίζει το κλειδί σας αμέσως, ώστε να το αντιγράψετε χωρίς καθυστέρηση. Δεν απαιτείται αριθμός τηλεφώνου για την εγγραφή. Λαμβάνετε $0.50 σε trial credit που ισχύει για 7 days, ώστε να δοκιμάσετε τη συνδεσιμότητα χωρίς να προσθέσετε κεφάλαιο.

Ρυθμίστε τη μεταβλητή περιβάλλοντος ή τον πελάτη SDK για να κατευθύνετε στο σωστό base URL. Αυτό το URL λειτουργεί με τυπικές βιβλιοθήκες OpenAI. Αλλάξτε μόνο το base URL και το key σας. Το model ID είναι "uncensored". Αυτό το μοναδικό endpoint διαχειρίζεται όλες τις συμπληρώσεις κειμένου. Δεν χρειάζεται να διαχειριστείτε routing ή να επιλέξετε διαφορετικά μοντέλα.

Βεβαιωθείτε ότι η βιβλιοθήκη πελάτη υποστηρίζει το πρωτόκολλο OpenAI Chat Completions. Οι περισσότερες σύγχρονες βιβλιοθήκες λειτουργούν έτοιμες. Επαληθεύστε ότι το δίκτυό σας επιτρέπει outbound HTTPS αιτήσεις. Η υπηρεσία δέχεται τυπικά payloads JSON. Δεν χρειάζονται ειδικά headers πέραν της πιστοποίησης.

Πιστοποίηση με API Keys

Περνάτε το API key σας στην κεφαλίδα Authorization για κάθε αίτηση. Χρησιμοποιήστε το σχήμα Bearer ακολουθούμενο από το string του κλειδιού σας. Η υπηρεσία επαληθεύει το κλειδί έναντι του λογαριασμού σας. Τα άκυρα κλειδιά επιστρέφουν σφάλμα 401 Unauthorized. Η λήξη ή η ανεπάρκεια κεφαλαίων ενεργοποιούν την απόκριση 402 Payment Required. Ελέγξτε το υπόλοιπό σας στο dashboard αν οι αιτήσεις αποτύχουν.

Κρατήστε το κλειδί σας ασφαλές. Κάθε λογαριασμός διατηρεί ένα ενεργό κλειδί. Η δημιουργία ενός νέου κλειδιού ακυρώνει το προηγούμενο. Μην μοιράζετε το κλειδί σας σε δημόσια αποθετήρια. Το API key είναι ο μοναδικός ταυτοποιητής για τη χρήση σας. Τα όρια ρυθμού εφαρμόζονται ανά κλειδί, όχι ανά λογαριασμό.

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

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

Αποστολή της πρώτης σας αίτησης

Στείλτε μια αίτηση POST στο endpoint chat completions. Συμπεριλάβετε το model ID "uncensored" και το ιστορικό των μηνυμάτων σας. Το API επιστρέφει μια απάντηση κειμένου. Μπορείτε να stream-άρετε την έξοδο ή να περιμένετε την πλήρη ολοκλήρωση. Κάθε αίτηση καταναλώνει tokens εισόδου και εξόδου. Τα σφάλματα δεν χρεώνουν credits. Οι απορρίψεις είναι δωρεάν.

Copyfrom openai import OpenAI

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

Η απάντηση περιλαμβάνει στατιστικά χρήσης. Παρακολουθήστε την κατανάλωση tokens για τη διαχείριση του προκαταβλημένου πιστωτικού σας υπολοίπου. Το μοντέλο απαντά χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενήλικων. Μπορείτε να στείλετε system prompts για να ορίσετε τη συμπεριφορά. Τα μηνύματα χρήστη οδηγούν τη συζήτηση. Το παράθυρο συμφραζομένων υποστηρίζει συνολικά 100,000 tokens.

Ξεκινήστε με μια απλή ανταλλαγή δύο μηνυμάτων. Αυτό επαληθεύει τη σύνδεση και την ποιότητα της απάντησης. Προσαρμόστε τη θερμοκρασία και το top_p για δημιουργικές ή ακριβείς εξόδους. Το API υποστηρίζει τυπικές παραμέτρους. Οι ακολουθίες διακοπής λειτουργούν όπως αναμένεται. Οι τιμές seed διασφαλίζουν επαναλήψιμα αποτελέσματα.

Streaming Αποκρίσεις μέσω SSE

Ενεργοποιήστε τη ροή (streaming) ρυθμίζοντας την παράμετρο stream σε true. Το API επιστρέφει Server-Sent Events (SSE) αντί για ένα μοναδικό αντικείμενο JSON. Κάθε chunk περιέχει ένα μέρος του παραγόμενου κειμένου. Διαβάστε chunks μέχρι να τελειώσει η ροή. Το τελευταίο chunk περιλαμβάνει τη συνολική χρήση token.

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) μειώνει την αντιλαμβανόμενη καθυστέρηση. Οι χρήστες βλέπουν κείμενο να εμφανίζεται σε πραγματικό χρόνο. Αυτό είναι ιδανικό για διεπαφές συνομιλίας. Διαχειριστείτε προσεκτικά τα μερικά tokens. Συγκολλήστε τα κομμάτια για να σχηματίσετε την πλήρη απάντηση. Ο διακομιστής κλείνει τη σύνδεση όταν ολοκληρωθεί η παραγωγή.

Παρακολουθήστε σφάλματα stream. Οι διακοπές δικτύου μπορεί να διακόψουν το stream. Εφαρμόστε λογική επανασύνδεσης αν χρειαστεί. Το API δεν επαναπέμπει την ιστορία. Ξεκινήστε μια νέα αίτηση αν το stream αποτύχει. Οι μετρήσεις tokens στο τελευταίο τμήμα αντανακλούν ολόκληρη την παραγωγή.

Διαχείριση Παραμέτρων και Λειτουργιών

Χρησιμοποιήστε τυπικές παραμέτρους για τον έλεγχο της παραγωγής. Ορίστε temperature για τυχαιότητα. Προσαρμόστε top_p για nucleus sampling. Ορίστε stop sequences για τερματισμό της παραγωγής νωρίτερα. Δώστε seed για προσδιοριστικές εξόδους. Ενεργοποιήστε τη λειτουργία JSON ρυθμίζοντας response_format σε json_object. Το μοντέλο επιστρέφει έγκυρο JSON όταν ζητηθεί.

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

Copyimport OpenAI from "openai";

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

Τα max tokens περιορίζουν το μήκος της εξόδου. Η προεπιλογή είναι 2.048 tokens. Ορίστε υψηλότερη τιμή αν χρειαστεί. Το απόλυτο όριο ανά αίτημα είναι 16.000 tokens. Το παράθυρο συμφραζομένων είναι 100.000 tokens. Προγραμματίστε το μήκος της ιστορίας ανάλογα. Οι ποινές συχνότητας και παρουσίας βοηθούν στη μείωση της επανάληψης.

Κατανόηση Ορίων και Σφαλμάτων

Τα όρια ρυθμού προστατεύουν τη σταθερότητα της υπηρεσίας. Μπορείτε να στείλετε 300 αιτήματα ανά λεπτό. Η ταυτόχρονη επεξεργασία περιορίζεται σε οκτώ ταυτόχρονα αιτήματα ανά κλειδί. Τα σώματα αιτημάτων δεν πρέπει να υπερβαίνουν τα 8 MB. Η υπέρβαση των ορίων επιστρέφει σφάλμα 429 Too Many Errors. Περιμένετε πριν επαναπροσπαθήσετε.

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

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