Dolphin AI API Quickstart

Authentication and Base URL

Το κλειδί API σας πιστοποιεί κάθε αίτημα. Χρησιμοποιήστε τη βασική διεύθυνση https://api.dolphinaimodels.com/v1 για όλα τα endpoints. Το σύστημα απαιτεί ένα έγκυρο κλειδί στο Authorization header. Χωρίς αυτό, τα αιτήματα αποτυγχάνουν ακαριαία.

Δημιουργήστε το κλειδί σας μέσω του πίνακα ελέγχου. Λαμβάνετε ένα ενεργό κλειδί ανά λογαριασμό. Αντικαταστήστε το παλιό σας κλειδί αν δημιουργήσετε ένα νέο. Το κλειδί παρέχει πρόσβαση στο uncensored model αμέσως.

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

Στείλτε ένα POST request στο /v1/chat/completions. Το ID του μοντέλου είναι uncensored. Αυτό το endpoint δέχεται text input και επιστρέφει text output. Μπορείτε να ρυθμίσετε παραμέτρους όπως temperature και top_p.

Ακολουθεί ένα βασικό παράδειγμα cURL για να ξεκινήσετε:

Copycurl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

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

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI. Σημειώστε τη βάση URL μας. Δώστε το API key σας. Η δομή του κώδικα μιμείται την τυπική χρήση OpenAI. Αυτό διασφαλίζει εύκολη μετανάστευση για υπάρχοντα projects.

Ρυθμίστε τον πελάτη με αυτές τις τιμές:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinaimodels.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 SDK Configuration

Αρχικοποιήστε τον πελάτη Node.js με παρόμοιο τρόπο. Ορίστε τη βάση URL και το κλειδί API. Το SDK χειρίζεται τη σειριοποίηση αυτόματα. Αυτή η προσέγγιση λειτουργεί τόσο για εφαρμογές server-side όσο και client-side.

Παράδειγμα διαμόρφωσης:

Copyimport OpenAI from "openai";

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

Διαχείριση Streaming Αποκρίσεων

Ενεργοποιήστε streaming ρυθμίζοντας stream: true. Το API επιστρέφει Server-Sent Events (SSE). Κάθε κομμάτι περιέχει μερικό κείμενο. Το τελευταίο κομμάτι περιλαμβάνει δεδομένα χρήσης tokens. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες.

Ροή της απάντησης:

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)

Κατανόηση Ορίων και Σφαλμάτων

Το παράθυρο συμφραζομένων είναι 100.000 tokens. Αυτό περιλαμβάνει την εντολή και την απάντηση. Μέγιστη έξοδος 16.000 tokens ανά αίτημα. Τα σφάλματα επιστρέφουν τυπικούς κωδικούς HTTP. Το 401 υποδεικνύει μη έγκυρο κλειδί. Το 402 σημαίνει ανεπαρκές πιστωτικό υπόλοιπο. Το 429 σηματοδοτεί περιορισμό ρυθμού.

Είστε περιορισμένοι σε 300 αιτήσεις ανά λεπτό. Η ταυτόχρονη εκτέλεση περιορίζεται σε 8 ταυτόχρονες αιτήσεις. Κρατήστε τα σώματα αιτήσεων κάτω από 8 MB. Αυτά τα όρια διασφαλίζουν σταθερή απόδοση για το φορτίο εργασίας σας.