Πώς σε Ενσωματώστε την API DeepSeek

Προαπαιτούμενα: Ρύθμιση Περιβάλλοντος

Ξεκινήστε διασφαλίζοντας ότι το περιβάλλον ανάπτυξής σας έχει το απαραίτητο SDK εγκατεστημένο. Χρειάζεστε μια γλώσσα runtime όπως Python ή Node.js και έναν τρόπο να αποθηκεύετε τα διαπιστευτήρια API σας με ασφάλεια. Αυτή η ρύθμιση είναι ίδια με τη χρήση οποιασδήποτε άλλης OpenAI-compatible υπηρεσίας.

Δεν χρειάζεται να εγκαταστήσετε drivers συγκεκριμένου κατασκευαστή. Το proxy αναλαμβάνει όλη την εξαγωγή μοντέλου, οπότε ο υπολογιστής σας χρειάζεται μόνο να στέλνει αιτήματα HTTP και να αναλύει απαντήσεις JSON. Αυτό μειώνει το κόστος εξαρτήσεων και κρατά το έργο ελαφρύ.

Εγκατάσταση του Επίσημου SDK

Εγκαταστήστε το επίσημο SDK για τη γλώσσα σας ώστε να διαχειρίζεται την πιστοποίηση και τη σειριοποίηση. Για Python, χρησιμοποιήστε pip install openai. Για Node.js, εκτελέστε npm install openai. Αυτή η βιβλιοθήκη διαχειρίζεται τις υποκείμενες συνδέσεις HTTP.

Το SDK απομακρύνει την πολυπλοκότητα της δημιουργίας JSON payloads. Εσείς μπορείτε να εστιάσετε στον ορισμό του prompt και στη διαχείριση των επιστρεφόμενων tokens. Αυτή η τυποποίηση σημαίνει ότι μπορείτε να αλλάξετε παρόχους αργότερα αλλάζοντας απλώς τη base URL.

Copyfrom openai import OpenAI

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

Ρύθμιση Base URL και Key

Κατευθύνετε τον πελάτη SDK στο βασικό URL proxy και εισάγετε το κλειδί API σας. Αυτό το βήμα διαμόρφωσης κατευθύνει την κίνηση μακριά από τους τυπικούς διακομιστές OpenAI. Πρέπει να ορίσετε το base_url για https://api.deepseekpago.com/v1.

Περνάτε το κλειδί σας μέσω της api_key parameter. Αυτό το κλειδί δημιουργείται όταν εγγραφείτε στην ιστοσελίδα. Πιστοποιεί τα αιτήματά σας και παρακολουθεί τη χρήση του προπληρωμένου σας πιστωτικού υπολοίπου. Χωρίς αυτή τη διαμόρφωση, τα αιτήματά σας θα αποτύχουν με σφάλμα 404 ή 401.

Κάντε την πρώτη αίτηση

Στείλτε μια απλή text completion για να επαληθεύσετε τη σύνδεση και τη συμπεριφορά του μοντέλου. Χρησιμοποιήστε το ID μοντέλου uncensored για πρόσβαση στο συγκεκριμένο μοντέλο που τρέχει στο proxy. Αυτό το μοντέλο είναι ρυθμισμένο να απαντά χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενήλικων.

Το σώμα της αίτησης περιλαμβάνει το messages array και το model identifier. The response contains the generated text in the content πεδίο. Αυτό επιβεβαιώνει ότι η ενσωμάτωσή σας λειτουργεί σωστά με το μοντέλο uncensored.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

Ενεργοποίηση Ροών Απαντήσεων (Streaming)

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

Διαχειριστείτε τη ροή επαναλαμβάνοντας τα τμήματα. Το τελευταίο τμήμα περιέχει τη συνολική χρήση 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)

Χρησιμοποιώντας Tools και Function Calling

Ορίστε εργαλεία στο request body για να επιτρέψετε στο μοντέλο να παράγει δομημένες εξόδους. Δώστε μια λίστα ορισμών συναρτήσεων στο tools parameter. Το μοντέλο θα επιστρέψει μια κλήση συνάρτησης αντί για απλό κείμενο όταν αυτό είναι κατάλληλο.

Αυτή η λειτουργία λειτουργεί ακριβώς όπως η API κλήσης συναρτήσεων της OpenAI. Μπορείτε να την ενσωματώσετε στη λογική της εφαρμογής σας για την εκτέλεση κώδικα ή την ενημέρωση βάσεων δεδομένων. Το proxy υποστηρίζει αυτό το πρότυπο πρωτόκολλο χωρίς τροποποιήσεις.

Copyimport OpenAI from "openai";

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

Επιβολή Μορφής Εξόδου JSON

Εξαναγκάστε το μοντέλο να επιστρέψει έγκυρο JSON ρυθμίζοντας response_format για {"type": "json_object"}. Αυτό είναι χρήσιμο για την ανάλυση δεδομένων στην εφαρμογή σας. Μειώνει την ανάγκη για επεξεργασία μετά την παραγωγή με μοτίβα regex.

Το μοντέλο συμμορφώνεται αυστηρά σε αυτόν τον περιορισμό. Εάν η έξοδος δεν είναι έγκυρο JSON, η αίτηση μπορεί να αποτύχει. Αυτό διασφαλίζει ότι η αλυσίδα παραγωγής σας παραμένει ισχυρή κατά την ενσωμάτωση με αυτοματοποιημένα συστήματα. Μπορείτε επίσης να ορίσετε temperature και top_p για να ελέγξετε τη δημιουργικότητα.

Χειρισμός Σφαλμάτων και Ορίων Ρυθμού

Η API επιβάλλει όριο 300 αιτήσεων ανά λεπτό ανά key. Αν το υπερβείτε, λαμβάνετε σφάλμα 429. Μπορείτε επίσης να έχετε έως 8 ταυτόχρονες αιτήσεις ανά key. Σεβαστείτε αυτά τα όρια για να αποφύγετε διακοπές της υπηρεσίας.

Τα σφάλματα επιστρέφονται ως τυπικά αντικείμενα JSON με κωδικό σφάλματος και μήνυμα. Διαχειριστείτε τα με χάρη στον κώδικά σας. Συνιστάται λογική επανάληψης με εκθετική υποχώρηση για παροδικά σφάλματα όπως οι αποκρίσεις 429 ή 503.

Παρακολούθηση Χρήσης Tokens

Παρακολουθήστε τη χρήση του προκαταβλεπόμενου πιστωτικού σας λογαριασμού παρακολουθώντας τους αριθμούς tokens. Το τελευταίο chunk σε μια απόκριση ροής περιλαμβάνει το usage αντικείμενο. Αυτό δείχνει μετρήσεις tokens εισόδου και εξόδου.

Οι τιμές είναι $0.15 ανά 1M input tokens και $0.50 ανά 1M output tokens. Τα σφάλματα είναι δωρεάν. Μπορείτε να υπολογίσετε το κόστος τοπικά πολλαπλασιάζοντας τα token counts με αυτούς τους συντελεστές. Αυτό σας βοηθά να προϋπολογίσετε τις προσθήκες κεφαλαίου crypto ακριβώς.