Γρήγορη εκκίνηση API μοντέλων AI Dolphin
Τα μοντέλα AI Dolphin παρέχουν μια απλή API συμβατή με OpenAI για συμπερασματολογία χωρίς λογοκρισία. Αυτός ο οδηγός γρήγορης εκκίνησης σας καθοδηγεί μέσω της πιστοποίησης, της αποστολής αιτημάτων και της διαχείρισης δεδομένων ροής (streaming) με προβλέψιμη χρέωση ανά token.
1. Προαπαιτούμενα: SDK και Κλειδί API
Εγγραφείτε χρησιμοποιώντας τον λογαριασμό Google ή το email για να λάβετε ένα κλειδί API αμέσως. Χρειάζεστε το επίσημο SDK για τη γλώσσα που προτιμάτε για να επικοινωνήσετε με το endpoint. Το κλειδί πιστοποιεί κάθε αίτημα που στέλνετε.
2. Διαμορφώστε τη Βασική σας Διεύθυνση
Ορίστε το βασικό URL σε HTTPS://api.dolphinmodelsai.com/v1 στη διαμόρφωση του πελάτη σας. Αυτό το URL κατευθύνει τα αιτήματά σας στους εξυπηρετητές συμπερασματικής επεξεργασίας uncensored. Βεβαιωθείτε ότι το κλειδί API σας περνάται στην κεφαλίδα εξουσιαστικοποίησης. Το σημείο άφιξης ακολουθεί τυπικά πρότυπα OpenAI για συμβατότητα.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.dolphinmodelsai.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. Αποστολή της πρώτης σας αίτησης ολοκλήρωσης συνομιλίας
Στείλτε μια αίτηση POST στο /v1/chat/completions με το model id "uncensored". Συμπεριλάβετε την ιστορία των μηνυμάτων σας στην παράμετρο messages. Το API επιστρέφει απάντηση κειμένου χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενηλίκων. Μπορείτε να προσαρμόσετε παραμέτρους όπως η θερμοκρασία για να ελέγξετε την τυχαιότητα.
curl https://api.dolphinmodelsai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the time complexity of this sorting algorithm"}]
}'
4. Ενεργοποιήστε το Streaming και Διαχειριστείτε τη Χρήση Tokens
Ορίστε streaming σε true για λήψη tokens καθώς παράγονται. Κάθε chunk περιέχει μερικό κείμενο και μεταδεδομένα χρήσης. Το τελευταίο chunk περιλαμβάνει τον συνολικό αριθμό tokens για ακρίβεια χρέωσης. Αυτή η προσέγγιση μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές απαντήσεις.
stream = 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. Χρήση JSON Mode για Δομημένη Έξοδο
Περάστε response_format ως {"type": "json_object"} για να επιβάλετε δομημένη έξοδο. Το μοντέλο εγγυάται έγκυρη σύνταξη JSON στην απόκριση. Αυτή η λειτουργία είναι ιδανική για την ανάλυση δεδομένων στη λογική της εφαρμογής σας. Απαλλάσσει από την ανάγκη για χειροκίνητη επικύρωση regex.
6. Υλοποίηση Function Calling (Tools)
Ορίστε εργαλεία στο αίτημά σας για να ενεργοποιήσετε τις δυνατότητες κλήσης συναρτήσεων. Το μοντέλο μπορεί να επιστρέψει κλήσεις εργαλείων αντί για απλό κείμενο. Εκτελείτε τη συνάρτηση και στέλνετε το αποτέλεσμα πίσω στο μοντέλο. Αυτό το μοτίβο υποστηρίζει πολύπλοκες ροές εργασίας πολλαπλών βημάτων.
7. Κατανόηση Ορίων Ρυθμού και Παραμέτρων
Κάθε κλειδί API περιορίζεται σε 300 αιτήσεις ανά λεπτό. Μπορείτε να έχετε 8 ταυτόχρονες αιτήσεις ανά πάσα στιγμή. Το παράθυρο πλαισίου υποστηρίζει έως 100,000 tokens για είσοδο και έξοδο συνολικά. Οι αιτήσεις που υπερβαίνουν αυτά τα όρια λαμβάνουν κωδικό σφάλματος 429. Τα σφάλματα πιστωτικών σημείων επιστρέφουν κατάσταση 402.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.dolphinmodelsai.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)Συχνές ερωτήσεις
Πώς μπορώ να πιστοποιήσω τα αιτήματά μου;
Συμπεριλάβετε το API key σας στην κεφαλίδα Authorization ως Bearer token. Το κλειδί δημιουργείται αμέσως μετά την εγγραφή. Παραμένει έγκυρο έως ότου το ακυρώσετε ή το αντικαταστήσετε.
Τι συμβαίνει αν ξεπεράσω το όριο ρυθμού;
Η API επιστρέφει σφάλμα 429 Too Many Requests. Πρέπει να περιμένετε μέχρι να επαναρυθμιστεί το παράθυρο ορίου. Ισχύουν επίσης όρια ταυτόχρονων αιτήσεων για την πρόληψη της εξάντλησης πόρων.
Το μοντέλο χωρίς λογοκρισία είναι δωρεάν;
Όχι, χρησιμοποιεί prepaid credit που χρεώνεται ανά token. Λαμβάνετε trial credit για νέους λογαριασμούς. Η χρέωση είναι διαφανής χωρίς κρυφές μηνιαίες χρεώσεις.
Κτήστε το κλειδί API σας τώρα.
Εγγραφείτε, αντιγράψτε το κλειδί, ενημερώστε το endpoint. Τέλος.
Δοκιμάστε με πιστωτικό υπόλοιπο δοκιμής