Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Η βασική διεύθυνση URL είναι https://api.apertusia.com/v1. Ορίστε το API key σας στην κεφαλίδα Authorization. Η ταυτότητα του μοντέλου είναι uncensored. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε πελάτη συμβατό με OpenAI.

Χρησιμοποιήστε αυτή την εντολή cURL για να ελέγξετε άμεσα τη σύνδεση. Αντικαταστήστε το YOUR_API_KEY με το πραγματικό σας κλειδί.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

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

2. Υποστηριζόμενες Παράμετροι: Θερμοκρασία, Top P και Seed

Ελέγξτε την τυχαιότητα με temperature, την ποικιλία με top_p και την αναπαραγωγιμότητα με seed. Αυτές οι παράμετροι ακολουθούν τα τυπικά πρότυπα της OpenAI. Ορίστε το temperature σε 0.7 για ισορροπημένο αποτέλεσμα ή σε 1.0 για μεγαλύτερη δημιουργικότητα. Χρησιμοποιήστε το top_p για να περιορίσετε τη δειγματοληψία στην κορυφαία πιθανότητα. Η παράμετρος seed διασφαλίζει πανομοιότυπα αποτελέσματα για αποσφαλμάτωση.

Παράδειγμα Python snippet για τοπικό έλεγχο:

Copyfrom openai import OpenAI

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

3. Ροές Αποκρίσεων με Server-Sent Events

Ενεργοποιήστε τη ροή δεδομένων ορίζοντας stream: true. Το API επιστρέφει τμήματα μέσω Server-Sent Events. Κάθε τμήμα περιέχει μερικό κείμενο και δεδομένα χρήσης tokens. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροχρόνιες απαντήσεις. Διαχειριστείτε τα SSE events για να ενημερώνετε το UI σας σε πραγματικό χρόνο.

Παράδειγμα Node.js με το επίσημο SDK:

Copyimport OpenAI from "openai";

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

4. Διαμόρφση Κλήσης Συναρτήσεων και Λειτουργίας JSON

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

5. Όρια Ρυθμού Αιτημάτων και Περιορισμέγεθος Αιτήματος

Κάθε κλειδί API υποστηρίζει 300 αιτήματα ανά λεπτό. Τα ταυτόχρονα αιτήματα περιορίζονται στα 8 ανά κλειδί. Το μέγιστο μέγεθος του σώματος αιτήματος είναι 8 MB. Το παράθυρο συμφραζομένων χωράει συνολικά 100,000 tokens. Η μέγιστη έξοδος ανά αίτημα είναι έως το πλήρες παράθυρο 100,000 tokens. Αφήστε το max_tokens μη ρυθμισμένο ή ρυμίστε το σε υψηλή τιμή, για να αποφύγετε την περικοπή. Τα σφάλματα δεν καταναλώνουν πιστωτικό υπόλοιπο. Δεν εκδίδονται επιστροφές χρημάτων, αλλά τα σφάλματα χρέωσης διορθώνονται μέσω της Υποστήριξης.

6. Πιστοποίηση και Διαχείριση Σφαλμάτων

Δημιουργήστε το κλειδί σας μέσω του πίνακα ελέγχου. Χρησιμοποιήστε σύνδεση με Google ή email. Το κλειδί εμφανίζεται άμεσα. Προσθέστε το στην κεφαλίδα Authorization: Bearer. Τα μη έγκυρα κλειδιά επιστρέφουν 401. Τα σφάλματα 429 υποδηλώνουν εξάντληση ορίου ρυθμού. Τα σφάλματα 402 σημαίνουν ότι το προπληρωμένο υπόλοιπό σας εξαντλήθηκε. Προσθέστε κεφάλαια με USDT ή USDC. Τα πιστωτικά μονάδες δεν λήγουν ποτέ.

Streaming

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)