Γρήγορη Έναρξη: ενσωμάτωση σε λίγα λεπτά

1. Εγκαταστήστε το SDK σας

Ξεκινήστε εγκαθιστώντας την επίσημη βιβλιοθήκη για τη γλώσσα σας. Οι περισσότεροι προγραμματιστές προτιμούν το τυπικό πακέτο επειδή ταιριάζει με το interface που ήδη γνωρίζουν. Εκτελέστε pip install openai για Python ή npm install openai για Node.js. Χρειάζεστε μόνο ένα SDK για να χειριστείτε όλες τις αιτήσεις.

2. Ορίστε τη βασική σας διεύθυνση

Ρυθμίστε τον πελάτη σας να κατευθύνει στο συγκεκριμένο endpoint σας. Πρέπει να υπεργράψετε τη προεπιλεγμένη βάση URL για να κατευθύνετε σωστά την κίνηση. Χρησιμοποιήστε https://api.unsencoredai.com/v1 ως τη βάση URL. Περνάτε το κλειδί API σας στο Authorization header. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε τυπικό OpenAI-compatible client.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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

Στείλτε ένα τυπικό αίτημα chat completion για να δημιουργήσετε κείμενο. Το model ID είναι uncensored. Μπορείτε να στείλετε system prompts για να καθοδηγήσετε τη συμπεριφορά. Το API επιστρέφει μια άμεση απάντηση κειμένου. Χρησιμοποιήστε την εντολή curl παρακάτω για να ελέγξετε άμεσα τη σύνδεση. Ελέγξτε την απάντησή σας για το choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Διαχειριστείτε τις streaming απαντήσεις

Ενεργοποιήστε τη ροή (streaming) για χαμηλότερη καθυστέρηση και έξοδο σε πραγματικό χρόνο. Ορίστε stream: true στην αίτησή σας. Το API στέλνει τμήματα μέσω Server-Sent Events. Μπορείτε να επεξεργαστείτε κάθε token καθώς φτάνει. Αυτό είναι ιδανικό για διεπαφές συνομιλίας ή σενάρια roleplay. Το τελικό τμήμα περιέχει στατιστικά χρήσης.

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)

5. Διαμόρφωση παραμέτρων

Ρύθμιση temperature, top_p, και stop ακολουθίες. Αυτά οι έλεγχοι επηρεάζουν τη δημιουργικότητα και το μήκος εξόδου. Μπορείτε επίσης να χρησιμοποιήσετε response_format για JSON mode. Το παράθυρο συμφραζομένων υποστηρίζει 100,000 tokens συνολικά. Μέγιστη έξοδος 16,000 tokens ανά αίτηση. Βελτιστοποιήστε αυτές τις ρυθμίσεις για την συγκεκριμένη περίπτωσή σας.

6. Όρια, σφάλματα και context

Διαχειριστείτε τα σφάλματα με χάρη χρησιμοποιώντας τυπικούς κωδικούς κατάστασης HTTP. Ένα σφάλμα 401 σημαίνει ότι το κλειδί API σας είναι μη έγκυρο. Ένα σφάλμα 402 υποδηλώνει ανεπαρκές προκαταβλημένο υπόλοιπο. Ένα σφάλμα 429 σηματοδοτεί ότι φτάσατε το όριο των 300 αιτήσεων ανά λεπτό. Το παράθυρο πλαισίου (context window) σας είναι 100.000 tokens. Αιτήσεις άνω των 8 MB ενδέχεται να αποτύχουν. Δεν εκδίδονται επιστροφές χρημάτων για το υπόλοιπο, αλλά τα σφάλματα είναι δωρεάν.