Οδηγός Ενσωμάτωσης: κλειδί API deepseek coder

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

Το κλειδί API σας πιστοποιεί κάθε αίτημα. Ορίστε τη βασική διεύθυνση στο https://api.deepseekcoderapikey.com/v1 στην διαμόρφωση του πελάτη σας. Αυτή η διεύθυνση URL διαχειρίζεται τόσο τα endpoints ολοκλήρωσης συνομιλίας όσο και μοντέλων χωρίς να απαιτεί επιπλέον τμήματα διαδρομής. Λαμβάνετε ένα κλειδί ανά λογαριασμό και η δημιουργία ενός νέου αντικαθιστά αμέσως το προηγούμενο κλειδί.

Αποθηκεύστε το κλειδί σε μια μεταβλητή περιβάλλοντος ονομασμένη DEEPSEEK_API_KEY ή περάστε το απευθείας στον πελάτη του SDK σας. Το endpoint δέχεται τυπικά headers, οπότε μπορείτε να εναλλάξετε παρόχους αλλάζοντας μόνο τη base URL και την τιμή του key. Αυτή η προσέγγιση λειτουργεί με Cursor, επεκτάσεις VS Code και τοπικά dev tools που αναμένουν ένα OpenAI-compatible interface.

Η πιστοποίηση αποτυγχάνει με status 401 αν λείπει το key ή είναι άκυρο. Χρησιμοποιήστε το

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

παράδειγμα για να επαληθεύσετε τη σύνδεση πριν ενσωματώσετε στη λογική της εφαρμογής σας.

Τερματικό Συμπληρώματος Συζήτησης (POST)

Στείλτε μηνύματα στο POST /v1/chat/completions σημείο τερματισμού (endpoint) χρησιμοποιώντας το ID μοντέλου uncensored. Αυτό το endpoint επεξεργάζεται text input και επιστρέφει text output, υποστηρίζοντας τόσο synchronous όσο και streaming απαντήσεις. Μπορείτε να διαμορφώσετε τη συμπεριφορά του μοντέλου χρησιμοποιώντας παραμέτρους όπως temperature, top_p, και stop sequences.

Το παράθυρο πλαισίου (context window) επιτρέπει έως 100,000 tokens για το συνδυασμένο prompt και την ολοκλήρωση. Αν δεν προσδιορίσετε ένα όριο max_tokens, το μοντέλο προεπιλέγει 2,048 tokens ανά αίτημα. Χρησιμοποιήστε το

Copyfrom openai import OpenAI

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

το παρακάτω δείγμα δείχνει πώς να δομήσετε μια τυπική αίτηση συνομιλίας με την επίσημη βιβλιοθήκη Python OpenAI.

Σφάλματα όπως ανεπαρκές πιστωτικό υπόλοιπο επιστρέφουν κωδικό κατάστασης 402, ενώ τα κακώς διατυπωμένα αιτήματα επιστρέφουν 400. Ελέγξτε το σώμα της απόκρισης για αναλυτικά μηνύματα σφάλματος για να εντοπίσετε γρήγορα τη δομή του payload σας.

Τελικό Σημείο Μοντέλων (GET)

Κάντε ερώτημα στα διαθέσιμα μοντέλα στέλνοντας ένα GET /v1/models αίτηση. Αυτό το endpoint επιστρέφει μια λίστα αντικειμένων μοντέλου, συμπεριλαμβανομένου του uncensored το ID του μοντέλου. Μπορείτε να χρησιμοποιήσετε αυτό το endpoint για να επαληθεύσετε ότι το API key σας είναι έγκυρο και ότι η υπηρεσία είναι online πριν κάνετε έντονη χρήση.

Η απάντηση περιλαμβάνει μεταδεδομένα όπως το ID του μοντέλου, τον τύπο αντικειμένου και τις πληροφορίες ιδιοκτησίας. Χρησιμοποιήστε αυτά τα δεδομένα για δυναμική διαμόρφωση της εφαρμογής σας ή για καταγραφή διαθέσιμων μοντέλων για αποσφαλμάτωση. Η ενότητα δεν απαιτεί body, μόνο τον τυπικό header πιστοποίησης.

Η ενσωμάτωση αυτού του ελέγχου στη διαδικασία εκκίνησης της εφαρμογής σας διασφαλίζει ότι η εφαρμογή θα αποτύχει γρήγορα αν η API είναι μη προσβάσιμη. Επίσης, σας βοηθά να επαληθεύσετε ότι η σωστή base URL έχει διαμορφωθεί πριν προχωρήσετε στις πραγματικές ολοκληρώσεις συνομιλίας.

Streaming Αποκρίσεις (SSE)

Ενεργοποιήστε τη ροή δεδομένων (streaming) ορίζοντας το stream parameter to true in your request. The API returns a Server-Sent Events (SSE) stream, delivering tokens as they are generated. This approach reduces perceived latency for coding assistants and allows real-time UI updates in your application.

Κάθε chunk περιέχει μερικό περιεχόμενο, και το τελικό chunk περιλαμβάνει τα στατιστικά συνολικής χρήσης tokens. Επεξεργαστείτε προσεκτικά το stream SSE για να διαχειριστείτε διακοπές δικτύου και να buffer έμμεσα 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)

παράδειγμα δείχνει πώς να χειριστείτε το stream σε JavaScript.

Η ροή δεδομένων (streaming) είναι ιδανική για παραγωγή κώδικα μεγάλου μήκους ή λεπτομερείς εξηγήσεις. Παρέχει μια ομαλότερη εμπειρία χρήστη σε σύγκριση με την αναμονή για ολόκληρη την απάντηση. Βεβαιωθείτε ότι ο πελάτης σας διαχειρίζεται σωστά το γεγονός τέλους ροής (end-of-stream) για να ολοκληρώσει την απάντηση.

Function Calling και JSON Mode

Χρησιμοποιήστε την κλήση συναρτήσεων για να επιτρέψετε στο μοντέλο να καλέσει εξωτερικά εργαλεία. Ορίστε τις συναρτήσεις σας στο tools parameter και καθορίστε το tool_choice για να ελέγξετε πότε το μοντέλο τα χρησιμοποιεί. Το API υποστηρίζει τυπικούς ορισμούς εργαλείων, επιτρέποντάς σας να ενσωματωθείτε με τις δικές σας backend υπηρεσίες.

Για δομημένες εξόδους, ενεργοποιήστε τη λειτουργία JSON ορίζοντας response_format για json_object. Αυτό αναγκάζει το μοντέλο να επιστρέψει έγκυρο JSON, το οποίο είναι χρήσιμο για την ανάλυση δεδομένων ρύθμισης ή απαντήσεις API. Το

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekcoderapikey.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 στο Node.js.

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

Όρια Ρυθμού και Περιορισμοί

Το κλειδί API σας είναι περιορισμένο σε 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες αιτήσεις. Το μέγιστο μέγεθος σώματος αιτήματος είναι 8 MB. Αν ξεπεράσετε αυτά τα όρια, το API επιστρέφει σφάλμα 429 Too Many Requests. Εφαρμόστε εκθετική υποχώρηση στον πελάτη σας για να διαχειριστείτε τα όρια ρυθμού με χάρη.

Σφάλματα όπως 401 υποδεικνύουν μη έγκυρο κλειδί, ενώ το 402 σηματοποιεί ανεπαρκή πιστωτικά. Οι επιστροφές χρημάτων δεν εκδίδονται για πιστωτικά, αλλά οι διπλές χρεώσεις μπορούν να επιλυθούν μέσω της σελίδας Υποστήριξης. Τα πιστωτικά δεν λήγουν ποτέ, οπότε μπορείτε να κάνετε επαναφόρτιση όταν σας βολεύει.

Το παράθυρο πλαισίου 100.000 tokens ισχύει για τη συνολική εντολή εισόδου και ολοκλήρωση. Παρακολουθήστε τη χρήση tokens για να μείνετε εντός προϋπολογισμού. Χρησιμοποιήστε το σύστημα προπληρωμένου πιστωτικού λογαριασμού για να πληρώσετε μόνο για ό,τι χρησιμοποιείτε, χωρίς μηνιαίες χρεώσεις ή συνδρομές.