Dolphin AI Integration Guide

Προαπαιτούμενα: Ρύθμιση SDK και API key

Εγκαταστήστε το επίσημο SDK για τη γλώσσα σας. Δημιουργήστε λογαριασμό μέσω email ή Google login στο dashboard μας. Δημιουργήστε το API key σας άμεσα. Δεν απαιτείται αριθμός τηλεφώνου. Το key εμφανίζεται μία φορά στην οθόνη. Αποθηκεύστε το με ασφάλεια. Δεν αποθηκεύουμε τη μέθοδο πληρωμής σας. Τα top-ups με κρυπτονομίσματα χρησιμοποιούν USDT ή USDC. Τα credits δεν λήγουν. Τα σφάλματα κοστίζουν μηδέν. Πληρώνετε μόνο για τα tokens που χρησιμοποιούνται.

Διαμόρφωση του base URL και των headers

Κατευθύνετε τον πελάτη σας στη βάση URL μας. Ορίστε την κεφαλίδα εξουσιαστικοποίησης με το key σας. Χρησιμοποιήστε το model ID "uncensored". Αυτό διασφαλίζει ότι χτυπάτε το μοντέλο μας χωρίς λογοκρισία. Δεν είναι GPT ή Claude. Το endpoint δέχεται τυπικές ολοκληρώσεις συνομιλίας. Οι κεφαλίδες πρέπει να περιλαμβάνουν το API key. Άλλα πεδία είναι προαιρετικά. Η θερμοκρασία και το top_p λειτουργούν όπως αναμένεται. Υποστηρίζουμε τυπικές παραμέτρους OpenAI. Ελέγξτε την τεκμηρίωση για τα όρια.

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

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

Στείλτε μια αίτηση POST με τα μηνύματά σας. Συμπεριλάβετε το system prompt για context. Ορίστε το περιεχόμενο του μηνύματος χρήστη. Το μοντέλο επιστρέφει μια απάντηση κειμένου. Μπορείτε να ορίσετε max tokens. Η προεπιλεγμένη έξοδος είναι 2,048 tokens. Ορίστε υψηλότερα όρια αν χρειαστεί. Το context window είναι 100,000 tokens. Η είσοδος και η έξοδος μοιράζονται αυτό το όριο. Βεβαιωθείτε ότι το prompt σας χωράει. Τα σφάλματα επιστρέφουν τυπικούς κωδικούς JSON. Ελέγξτε το body της απάντησης για σφάλματα.

Copyfrom openai import OpenAI

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

Ενεργοποίηση ροής για απαντήσεις σε πραγματικό χρόνο

Ορίστε streaming σε true στο αίτημά σας. Το API επιστρέφει chunks μέσω SSE. Κάθε chunk περιέχει μερικό κείμενο. Επεξεργαστείτε τα tokens καθώς φτάνουν. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση. Λαμβάνετε άμεση ανατροφοδότηση. Το τελευταίο chunk περιλαμβάνει χρήση tokens. Παρακολουθήστε τη χρήση για παρακολούθηση κόστους. Το streaming λειτουργεί με όλες τις παραμέτρους. Τα εργαλεία και η λειτουργία JSON επίσης stream. Διαχειριστείτε διακοπές σύνδεσης ομαλά. Επανασυνδεθείτε αν η ροή αποτύχει.

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)

Χρήση εργαλείων και κλήσης συναρτήσεων

Ορίστε schemas συναρτήσεων στην αίτησή σας. Περνάστε τα ως εργαλεία στο API. Το μοντέλο επιστρέφει κλήσεις εργαλείων. Αναλύστε τα ορίσματα για εκτέλεση. Υποβάλετε ξανά τα αποτελέσματα στο μοντέλο. Αυτό επιπλέκει πολύπλοκες ροές εργασίας. Η υποστήριξη είναι τυπική μορφή OpenAI. Η επιλογή εργαλείου μπορεί να είναι αυτόματη. Μπορείτε να αναγκάσετε συγκεκριμένα εργαλεία. Η λειτουργία JSON λειτουργεί και με εργαλεία. Βεβαιωθείτε ότι το schema είναι έγκυρο. Τα άκυρα schemas προκαλούν σφάλματα. Δοκιμάστε με απλές συναρτήσεις πρώτα.

Copyimport OpenAI from "openai";

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

Διαχείριση ορίων ρυθμού και σφαλμάτων

Επιβάλλουμε 300 αιτήσεις ανά λεπτό. Οι ταυτόχρονες αιτήσεις περιορίζονται στις οκτώ. Τα σώματα αιτήσεων πρέπει να είναι κάτω από 8 MB. Σφάλμα 401 σημαίνει άκυρο key. Ελέγξτε τον header πιστοποίησης. Σφάλμα 402 υποδεικνύει έλλειψη υπολοίπου. Κάντε επαναφορά με crypto για να συνεχίσετε. 429 σημαίνει ότι φτάσατε το όριο ρυθμού. Περιμένετε και δοκιμάστε ξανά με backoff. Τα σφάλματα είναι δωρεάν. Μόνο τα ολοκληρωμένα tokens κοστίζουν υπόλοιπο. Η συνάφεια είναι 100.000 tokens συνολικά.