Dolphin AI API Quickstart

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

Ξεκινήστε ρυθμίζοντας τη base URL και το API key στη διαμόρφωση του client σας. Όλα τα αιτήματα επαληθεύονται μέσω του Authorization header χρησιμοποιώντας το μοναδικό σας κλειδί. Η υπηρεσία μας λειτουργεί ως ανεξάρτητος πάροχος για το openrouter dolphin AI variant του μοντέλου, δηλαδή δεν χρειάζεστε λογαριασμό στο OpenRouter για να χρησιμοποιήσετε αυτό το endpoint. Απλά πάρτε το key σας από το dashboard και τοποθετήστε το στις μεταβλητές περιβάλλοντος.

• Base URL: https://api.openrouterdolphinai.com/v1
• Header: Authorization: Bearer YOUR_API_KEY

Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε τυπικό OpenAI SDK επειδή μιμούμαστε την ακριβή δομή endpoint τους. Θα αλληλεπιδράσετε μόνο με το endpoint chat completions, κρατώντας την ενσωμάτωσή σας απλή και εστιασμένη στη δημιουργία κειμένου.

Πρώτη αίτηση

Στείλτε το πρώτο μήνυμα για να δημιουργήσετε κείμενο χρησιμοποιώντας το απλό POST method. The model ID is always uncensored, το οποίο εξασφαλίζει ότι λαμβάνετε τη συγκεκριμένη uncensored έκδοση ρυθμισμένη για μη περιορισμένη συνομιλία. Δεν χρειάζεται να καθορίσετε πολύπλοκες παραμέτρους δρομολόγησης καθώς φιλοξενούμε αυτό το μοναδικό μοντέλο απευθείας.

Χρησιμοποιήστε την ακόλουθη εντολή curl για να δοκιμάσετε τη σύνδεσή σας άμεσα:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

Αν λάβετε JSON απόκριση με περιεχόμενο, το key σας είναι ενεργό και τα credits αφαιρούνται σωστά. Σφάλματα όπως το 401 υποδηλώνουν άκυρο key, ενώ το 402 σημαίνει ότι χρειάζεται επαναφόρτωση μέσω crypto. Αυτή η άμεση προσέγγιση αποφεύγει την μεταβλητότητα των routers πολλαπλών μοντέλων.

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

Ενσωματώστε γρήγορα χρησιμοποιώντας την επίσημη βιβλιοθήκη Python του OpenAI κατευθύνοντάς την στο base URL μας. Αυτό σας επιτρέπει να χρησιμοποιείτε γνωστές μεθόδους όπως chat.completions.create() χωρίς να αναγράψετε ξανά όλη τη λογική. Η βιβλιοθήκη χειρίζεται αυτόματα τη σειριοποίηση, οπότε μπορείτε να εστιάσετε στον σχεδιασμό των prompts παρά στις λεπτομέρειες HTTP.

Ρυθμίστε τον πελάτη με τη βασική διεύθυνση URL και το κλειδί:

Copyfrom openai import OpenAI

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

Θυμηθείτε ότι το παράθυρο συμφραζομένων μας είναι 100,000 tokens, οπότε μπορείτε να περάσετε ουσιαστική ιστορία συνομιλίας. Η SDK θα χειριστεί την tokenization και τη μετάδοση αποδοτικά, διασφαλίζοντας ότι οι διατυπώσεις σας φτάνουν στο μοντέλο χωρίς περιττή επιβάρυνση ή σφάλματα μορφοποίησης.

Node SDK Usage

Node developers can achieve the same results using the openai πακέτο npm. Όπως και η έκδοση Python, πρέπει να αντικαταστήσετε το προεπιλεγμένο base URL για να δείχνει στους αφιερωμένους διακομιστές μας. Αυτό διασφαλίζει ότι οι αιτήσεις σας πηγαίνουν απευθείας στο μοντέλο χωρίς φιλτράρισμα χωρίς να χτυπούν όρια ρυθμού τρίτων παρόχων ή καθυστερήσεις δρομολόγησης.

Προσδιορίστε τον πελάτη με τη σωστή διεπαφή:

Copyimport OpenAI from "openai";

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

Αυτό το μοτίβο λειτουργεί τόσο για συγχρονικές κλήσεις όσο και για μοτίβα async/await. Μπορείτε να ρεύσετε απαντήσεις ή να ζητήσετε λειτουργία JSON απευθείας μέσα στην ίδια κλήση συνάρτησης, προσφέροντάς σας ευελιξία για διαφορετικές αρχιτεκτονικές εφαρμογών χωρίς να αλλάξετε τη βασική ρύθμιση πιστοποίησης.

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)

Κάθε τμήμα περιλαμβάνει δεδομένα χρήσης στο τελευταίο κομμάτι, ώστε να μπορείτε να παρακολουθείτε τα κόστη με ακρίβεια. Το streaming είναι ιδανικό για chat interfaces όπου η άμεση ανατροφοδότηση βελτιώνει τη συμμετοχή των χρηστών. Μπορείτε να διακόψετε τη ροή ανά πάσα στιγμή αν ο χρήστης στείλει ένα νέο μήνυμα, εξοικονομώντας credits για μερικές αποκρίσεις.

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

Κατανοήστε τα τεχνικά όρια για να αποφύγετε απροσδόκητες διακοπές στην εφαρμογή σας. Η API μας επιβάλλει ένα παράθυρο συνάφειας 100,000 tokens για κάθε αίτημα, συνδυάζοντας τόσο prompt όσο και completion. Αν υπερβείτε το όριο εξόδου 16,000 tokens, η δημιουργία θα σταματήσει, οπότε ρυθμίστε max_tokens κατάλληλα για έλεγχο κόστους.

Συνήθεις κωδικοί κατάστασης HTTP περιλαμβάνουν 401 για μη έγκυρα κλειδιά, 402 για ανεπαρκές υπόλοιπο και 429 για όρια ρυθμού. Περιορίζεστε σε 300 αιτήματα ανά λεπτό ανά κλειδί. Αυτοί οι περιορισμοί διασφαλίζουν δίκαιη χρήση για όλους τους χρήστες. Χρησιμοποιήστε το 429 σφάλμα για να εφαρμόσετε εκθετική υποχώρηση στον κώδικα του πελάτη σας, διασφαλίζοντας ομαλή λειτουργία κατά τις περιόδους αιχμής.