Τεκμηρίωση API

Πιστοποίηση και base URL

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

Πρώτο παράδειγμα αίτησης

Στείλτε μια απλή ολοκλήρωση συνομιλίας για να ελέγξετε τη σύνδεση. Το ID του μοντέλου είναι "uncensored". Διαχειρίζεται κείμενο εισόδου και εξόδου αποδοτικά. Μπορείτε να προσαρμόσετε παραμέτρους όπως η θερμοκρασία για δημιουργικότητα.

Copyfrom openai import OpenAI

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

Χρησιμοποιήστε το επίσημο Node SDK για εύκολη ενσωμάτωση. Ορίστε το base URL στο τερματικό σημείο μας. Περάστε το API key σας στο αντικείμενο διαμόρφωσης. Αυτή η προσέγγιση λειτουργεί με τις περισσότερες τυπικές βιβλιοθήκες συμβατές με OpenAI.

Copyimport OpenAI from "openai";

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

Διαχειριστείτε τις απαντήσεις απευθείας στο περιβάλλον JavaScript σας. Η δομή ταιριάζει με τα τυπικά σχήματα OpenAI για εξοικείωση.

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

Ενεργοποιήστε τη ροή δεδομένων (streaming) ορίζοντας stream: true. Λαμβάνετε tokens καθώς παράγονται. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες. Το τελευταίο chunk περιλαμβάνει λεπτομέρειες συνολικής χρήσης 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)

Ανάλυση των γεγονότων SSE για ενημέρωση του UI σας σε πραγματικό χρόνο. Αυτό είναι ιδανικό για διεπαφές συνομιλίας που απαιτούν άμεση ανατροφοδότηση.

Παράμετροι και όρια

Ρυθμίστε θερμοκρασία, top_p και seed για έλεγχο. Μέγιστη έξοδος 16,000 tokens. Παράθυρο πλαισίου 100,000 tokens. Όριο ρυθμού 300 αιτήσεις ανά λεπτό. Μέγιστο μέγεθος σώματος 8 MB.

Αυτά τα όρια διασφαλίζουν σταθερή απόδοση. Η υπέρβαση των ορίων ρυθμού επιστρέφει σφάλμα 429. Αυξήστε τη συνάφεια αν χρειαστεί.

Σφάλματα και παράθυρο πλαισίου

Διαχειριστείτε το 401 για μη έγκυρα keys. Χρησιμοποιήστε 402 όταν το credit είναι χαμηλό. Το 429 υποδεικνει υπέρβαση ορίου ρυθμού. Τα σφάλματα και οι απορρίψεις είναι δωρεάν. Το προπληρωμένο credit σας δεν λήγει ποτέ. Το παράθυρο συνάφειας μετράει τα tokens prompt και completion μαζί.

Παρακολουθήστε τη χρήση μέσω του τελευταίου chunk στη ροή. Αυτό σας βοηθά να μείνετε εντός προϋπολογισμού. Δεν ισχύουν κρυφές χρεώσεις.

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'