Dolphin uncensored API Τεκμηρίωση

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

Ξεκινήστε διασφαλίζοντας ότι το περιβάλλον σας έχει τα απαραίτητα dependencies εγκατεστημένα πριν κάνετε οποιαδήποτε αίτηση. Θα χρειαστείτε ένα ενεργό API key από το dashboard μας και μια υποστηριζόμενη runtime όπως Python ή Node.js. Το API μας απαιτεί να στέλνετε αιτήματα σε ένα συγκεκριμένο base URL αντί για το προεπιλεγμένο endpoint του OpenAI.

Διατηρήστε το API key σας ασφαλές και αποθηκεύστε το σε μια μεταβλητή περιβάλλοντος. Αυτό αποτρέπει την ακούσια έκθεση στον αποθετήριο κώδικά σας. Μπορείτε να δημιουργήσετε ένα νέο κλειδί ακαριαία μετά την εγγραφή με Google ή email.

Δεν χρειάζεται να διαμορφώσετε πολύπλοκη διαδρομή ή να επιλέξετε συγκεκριμένα μοντέλα. Το σημείο τερματισμού εξυπηρετεί ένα μοναδικό uncensored large language model σχεδιασμένο για άμεση εξαγωγή κειμένου.

Εγκατάσταση του Επίσημου SDK OpenAI

Εγκαταστήστε το πακέτο επίσημου SDK για να διαχειρίζεται αυτόματα την πιστοποίηση και τον σχηματισμό αιτημάτων. Αυτή η βιβλιοθήκη υποστηρίζει περιβάλλοντα Python και Node.js με συνεπείς διεπαφές.

Για χρήστες Python, εκτελέστε την τυπική εντολή pip install για να προσθέσετε τη βιβλιοθήκη στο virtual environment σας. Οι προγραμματιστές Node.js πρέπει να χρησιμοποιήσουν το npm για να εγκαταστήσουν το ισοδύναμο πακέτο.

Το SDK διαχειρίζεται τη δομή του JSON payload για εσάς, οπότε χρειάζεται μόνο να εστιάσετε στο περιεχόμενο του prompt και σε παραμέτρους όπως temperature ή top_p.

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

Ρύθμιση Base URL και API Key

Κατευθύνετε τον πελάτη SDK σας στο συγκεκριμένο βασικό URL μας για να κατευθύνετε τις αιτήσεις προς την υποδομή μας χωρίς λογοκρισία. Χρησιμοποιήστε https://api.dolphinuncensored.com/v1 ως το endpoint σας.

Ορίστε το API key σας στην κεφαλίδα εξουσιαστικοποίησης (authorization header) ή στο αντικείμενο διαμόρφωσης του πελάτη. Ο πελάτης θα προσθέτει αυτόματα αυτό το key σε κάθε αίτημα.

Βεβαιωθείτε ότι καθορίζετε το ID μοντέλου ως "uncensored" στη διαμόρφωσή σας. Αυτό λέει στον διακομιστή ποια έκδοση μοντέλου να χρησιμοποιήσει για τη δημιουργία σας.

Κάντε την πρώτη ολοκλήρωση συνομιλίας

Στείλτε ένα απλό μήνυμα για να επαληθεύσετε τη σύνδεση και να λάβετε μια απόκριση. Αυτό επιβεβαιώνει ότι το κλειδί σας είναι έγκυρο και το endpoint είναι προσβάσιμο.

Χρησιμοποιήστε το endpoint chat-completions με ένα system prompt και ένα user message. Η απόκριση θα περιέχει το παραγόμενο κείμενο στο πεδίο content.

Κατανόηση της Ροής και της Χρήσης Tokens

Ενεργοποιήστε τη ροή για λήψη tokens καθώς παράγονται αντί να περιμένετε την πλήρη απάντηση. Αυτό βελτιώνει την αντιλαμβανόμενη καθυστέρηση για μακρές εξόδους.

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

Ορίστε την παράμετρο stream σε true στο σώμα της αίτησής σας. Επαναλάβετε τα chunks για να χτίσετε το τελικό κείμενό σας ή να το επεξεργαστείτε σε πραγματικό χρόνο.

Χειρισμός Σφαλμάτων και Απορρίψεων

Διαχειριστείτε τα σφάλματα HTTP 401 επαληθεύοντας ότι το API key σας είναι σωστό και όχι ληγμένο. Ένα σφάλμα 402 υποδεικνύει ανεπαρκά προπληρωμένα credit· προσθέστε credit μέσω crypto για να συνεχίσετε.

Η κατάσταση 429 σημαίνει ότι χτύπησατε το όριο ρυθμού των 300 αιτημάτων ανά λεπτό. Περιμένετε λίγο πριν ξαναπροσπαθήσετε ή μειώστε την ταυτόχρονη λειτουργία.

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

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Ροή

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)