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

Βασικό URL και Αυθεντικοποίηση

Συνδεθείτε χρησιμοποιώντας τη συμβατή με OpenAI βασική διεύθυνση URL. Αντικαταστήστε το υπάρχον κλειδί API σας με αυτό που δημιουργήσατε από το dashboard σας. Υποστηρίζουμε οποιαδήποτε βιβλιοθήκη client που δέχεται override βασικής διεύθυνσης URL.

• Base URL: https://api.dolphinnsfw.com/v1
• Πιστοποίηση: Bearer token στο Authorization header.

Η πιστοποίηση είναι άμεση. Το key σας λειτουργεί αμέσως μετά τη δημιουργία. Δεν απαιτείται αριθμός τηλεφώνου. Εγγραφείτε με Google ή email. Το dashboard δείχνει το key σας μία φορά. Τα σφάλματα είναι δωρεάν. Οι απορρίψεις κοστίζουν τίποτα. Αυτό διασφαλίζει ότι πληρώνετε μόνο για πραγματικά tokens.

Πρώτη αίτηση

Στείλτε μια αίτηση ολοκλήρωσης στο endpoint συνομιλίας. Το model id είναι uncensored. Διαχειρίζεται θέματα ενηλίκων χωρίς απόρριψη. Χρησιμοποιήστε τυποποιημένες δομές JSON. Το σώμα της αίτησης περιλαμβάνει μηνύματα και παραμέτρους.

Ακολουθεί μια απλή εντολή curl για τον έλεγχο της σύνδεσης. Στέλνει ένα σύντομο prompt. Η απόκριση επιστρέφει παραγόμενο κείμενο. Ελέγξτε τον κωδικό κατάστασης για επιτυχία.

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

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

Ενσωμάτωση SDK Python

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI. Ορίστε τη βάση URL στο endpoint μας. Δώστε το API key σας. Ο κώδικας παραμένει ταυτόσημος με την τυπική χρήση GPT. Αυτό μειώνει σημαντικά τον χρόνο ενσωμάτωσης.

Εγκαταστήστε τη βιβλιοθήκη. Ρυθμίστε τον πελάτη. Στείλτε μηνύματα. Το αντικείμενο απόκρισης περιέχει το παραγόμενο κείμενο. Μπορείτε να προσπελάσετε τη χρήση token από την απόκριση. Αυτό βοηθά στην παρακολούθηση του κόστους.

Copyfrom openai import OpenAI

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

Η βιβλιοθήκη χειρίζεται τις επαναπροσπάθειες. Διαχειρίζεται τους headers αυτόματα. Λαμβάνετε δομημένα δεδομένα. Αυτή η προσέγγιση λειτουργεί τόσο για τοπικά scripts όσο και για web apps.

Node SDK Integration

Αρχικοποιήστε τον πελάτη Node.js. Στερεώστε τον στη βάση URL μας. Χρησιμοποιήστε το κλειδί API. Η σύνταξη μιμείται την επίσημη τεκμηρίωση. Αυτό διασφαλίζει τη συνέπεια μεταξύ γλωσσών.

Δημιουργήστε μια εγκατάσταση πελάτη. Ορίστε το μοντέλο. Στείλτε μια εντολή. Η απόκριση περιέχει το περιεχόμενο. Μπορείτε να αναλύσετε το JSON εύκολα. Αυτό λειτουργεί καλά για απόδοση στην πλευρά του διακομιστή. Ταιριάζει επίσης σε συναρτήσεις serverless.

Copyimport OpenAI from "openai";

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

Το SDK διαχειρίζεται εσωτερικά τη ροή. Μπορείτε επίσης να κάνετε λήψη χειροκίνητα. Αυτό σας δίνει ευελιξία. Επιλέξτε τη μέθοδο που ταιριάζει στην αρχιτεκτονική σας.

Ροή και Χρήση Εργαλείων

Ενεργοποιήστε τη ροή για έξοδο σε πραγματικό χρόνο. Ορίστε την παράμετρο stream σε true. Η API στέλνει τμήματα μέσω Server-Sent Events. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση. Οι χρήστες βλέπουν το κείμενο καθώς παράγεται.

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

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 λειτουργεί με όλες τις παραμέτρους. Η temperature και η top_p εφαρμόζονται ανά chunk. Αυτό επιτρέπει λεπτομερή έλεγχο. Μπορείτε να διακόψετε την παραγωγή νωρίτερα. Το τελευταίο chunk περιέχει τη συνολική χρήση tokens.

Όρια, Σφάλματα και Context

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

Διαχειριστείτε τα σφάλματα με χάρη. Ένα σφάλμα 401 σημαίνει μη έγκυρο κλειδί. Ένα σφάλμα 402 υποδηλώνει έλλειψη υπολοίπου. Ένα σφάλμα 429 σηματοδολεί περιορισμό ρυθμού. Αυτοί είναι τυπικοί κωδικοί HTTP. Ο πελάτης σας πρέπει να κάνει επανάληψη ή να ειδοποιήσει τον χρήστη.

Η τιμολόγηση είναι διαφανής. Τα input tokens κοστίζουν $0.15 ανά εκατομμύριο. Τα output tokens κοστίζουν $0.50 ανά εκατομμύριο. Τα σφάλματα δεν καταναλώνουν πιστωτικό υπόλοιπο. Αυτό προστατεύει τον προϋπολογισμό σας. Το προκαταβολικό πιστωτικό υπόλοιπο δεν λήγει. Χρησιμοποιήστε το πιστωτικό υπόλοιπο δοκιμής για να δοκιμάσετε πρώτα.