Γρήγορη Έναρξη API Model Dolphin ai

Εγκαταστήστε το προτιμώμενο SDK

Ξεκινήστε εγκαθιστώντας τη βιβλιοθήκη για τη γλώσσα σας. Αυτό το πακέτο διαχειρίζεται τη σειριοποίηση και την αυθεντικοποίηση αυτόματα.

Εκτελέστε την εντολή για το περιβάλλον σας. Προσθέτει τις απαραίτητες εξαρτήσεις στο project σας.

• Python: pip install openai
• Node.js: npm install openai

Αυτά τα SDKs υποστηρίζουν τις ίδιες διεπαφές που χρησιμοποιούνται από τους μεγάλους παρόχους. Λαμβάνετε τυπικούς τύπους σφαλμάτων και αντικείμενα απόκρισης.

Ρυθμίστε τη βάση URL και το κλειδί

Κατευθύνετε τον πελάτη σας προς το endpoint μας που φιλοξενείται. Αντικαταστήστε το προεπιλεγμένο URL με τη συγκεκριμένη διεύθυνση base μας.

• Base URL: https://api.dolphinaimodel.com/v1
• ID Μοντέλου: uncensored

Ορίστε το API key σας στη μεταβλητή περιβάλλοντος OPENAI_API_KEY. Το SDK διαβάζει αυτόματα αυτό. Η πιστοποίηση χρησιμοποιεί τυπικούς headers bearer token. Δεν απαιτούνται ειδικά headers.

Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε OpenAI-compatible πελάτη. Αποφεύγετε την πολυπλοκότητα proxy χρησιμοποιώντας την τυπική διεπαφή απευθείας.

Στείλτε την πρώτη ολοκλήρωση

Κάντε μια αίτηση POST στο /v1/chat/completions. Το μοντέλο απαντά ελεύθερα για νόμιμη χρήση ενήλικων. Δεν απορρίπτει αμφιλεγόμενα ή ρητά θέματα εξ ορισμού.

Στείλτε το prompt σας στην array μηνυμάτων. Η απάντηση περιέχει το παραγόμενο κείμενο στο πεδίο content. Μπορείτε να προσαρμόσετε τη θερμοκρασία και το top_p για έλεγχο.

Αυτό το endpoint διαχειρίζεται μόνο παραγωγή κειμένου. Δεν υποστηρίζει embeddings ή παραγωγή εικόνας. Κρατήστε τα αιτήματά σας απλά για τα καλύτερα αποτελέσματα.

Τα σφάλματα επιστρέφουν τυπικούς κωδικούς κατάστασης HTTP. Ελέγξτε το σώμα της απόκρισης για λεπτομέρειες για τις αποτυχίες.

Διαχειριστείτε απαντήσεις ροής (streaming)

Ενεργοποιήστε streaming ρυθμίζοντας stream: true. Ο διακομιστής στέλνει τμήματα μέσω Server-Sent Events (SSE). Κάθε τμήμα περιέχει μερικό κείμενο.

Επεξεργαστείτε κάθε τμήμα καθώς φτάνει. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές απαντήσεις. Το τελευταίο τμήμα περιλαμβάνει στατιστικά χρήσης tokens.

Το streaming λειτουργεί με όλες τις παραμέτρους. Μπορείτε να διακόψετε τη ροή στη μέση αν χρειαστεί. Η σύνδεση κλείει καθαρά μετά την ολοκλήρωση.

Χρησιμοποιήστε αυτό για διαδραστικές εφαρμογές. Παρέχει άμεση ανατροφοδότηση στους χρήστες χωρίς να περιμένει την πλήρη δημιουργία.

Χρησιμοποιήστε εργαλεία και λειτουργία JSON

Ορίστε ορισμούς συναρτήσεων στην αίτηση. Το μοντέλο μπορεί να καλέσει αυτές τις συναρτήσεις βάσει του prompt σας. Χρησιμοποιήστε tool_choice για να επιβληθεί συγκεκριμένη συμπεριφορά.

Ενεργοποίηση λειτουργίας JSON με response_format. Η έξοδος είναι αυστηρά διαμορφωμένη ως αντικείμενο JSON. Αυτό διασφαλίζει αξιόπιστη ανάλυση στον κώδικά σας.

Συνδυάστε εργαλεία με streaming για σύνθετες ροές εργασίας. Μπορείτε να χειριστείτε πολλαπλές κλήσεις συναρτήσεων σε μια μοναδική στροφή. Το μοντέλο ακολουθεί το σχήμα σας με ακρίβεια.

Δοκιμάστε με απλά εργαλεία πρώτα. Επαληθεύστε τη δομή εξόδου πριν την ενσωμάτωση σε συστήματα παραγωγής.

Διαχειριστείτε τα όρια tokens

Το παράθυρο πλαισίου είναι 100.000 tokens συνολικά. Αυτό περιλαμβάνει τόσο tokens εισόδου όσο και εξόδου. Σχεδιάστε τα prompts σας ανάλογα.

Η μέγιστη έξοδος είναι 16.000 tokens ανά αίτημα. Αν δεν ορίσετε max_tokens, το όριο προεπιλογής είναι 2.048. Προσαρμόστε αυτή την παράμετρο για μακροβιότερες απαντήσεις.

Τα όρια ρυθμού είναι 300 αιτήματα ανά λεπτό. Μπορείτε να έχετε 8 ταυτόχρονες αιτήσεις ανά κλειδί. Η υπέρβαση αυτών των ορίων επιστρέφει κωδικό κατάστασης 429.

Παρακολουθήστε τη χρήση σας μέσω των headers της απόκρισης. Οι μετρήσεις tokens περιλαμβάνονται σε κάθε απόκριση. Αυτό σας βοηθά να παραμείνετε εντός των ορίων του προκαταβλημένου πιστωτικού σας υπολοίπου.

cURL

Copycurl https://api.dolphinaimodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the factorial of 42"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Ροή

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)