Γρήγορη Έναρξη: Ενσωμάτωση API Κώδικα DeepSeek

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

Το API key σας ταυτοποιεί κάθε αίτηση προς το endpoint μας. Χρησιμοποιήστε τη βάση URL https://api.coderdeepseek.cc/v1 με οποιοδήποτε OpenAI SDK ή HTTP client. Το model identifier είναι αυστηρά uncensored. Αυτό λειτουργεί στους δικούς μας διακομιστές και δεν είναι επαναπώληση μοντέλου άλλου παρόχου. Λαμβάνετε άμεσα ένα κλειδί API κατά την εγγραφή μέσω Google ή email. Διατηρήστε αυτό το κλειδί ασφαλές, καθώς ελέγχει το προκαταβληθέν υπόλοιπό σας.

Η πιστοποίηση βασίζεται στο Authorization header. Δώστε το κλειδί σας ως Bearer token. Κάθε αίτηση πρέπει να περιλαμβάνει αυτό το header για να αποφύγετε ένα 401 σφάλμα. Δεν χρησιμοποιούμε παραμέτρους ερώτησης για την αυθεντικοποίηση. Αυτό διασφαλίζει καθαρούς headers και συμβατότητα με τυπικά middleware.

Αποστολή Αιτημάτων: Chat Completions

Το endpoint chat completations επεξεργάζεται τα αιτήματά σας και επιστρέφει εξόδους κειμένου. Στείλτε μια POST αίτηση στο /v1/chat/completions. Συμπελάβετε το όνομα του μοντέλου, τον πίνακα μηνυμάτων και τις επιθυμητές παραμέτρους σας. Το σύστημα επεξεργάζεται κείμενο και επιστρέφει κείμενο. Μπορείτε να ελέγξετε τη μορφή της απόκρισης και τα κριτήρια διακοπής. Αυτό λειτουργεί τόσο για απλές ερωτήσεις όσο και για σύνθετες εργασίες προγραμματισμού.

Χρησιμοποιήστε την ακόλουθη εντολή curl για να δοκιμάσετε τη σύνδεσή σας. Αντικαταστήστε YOUR_API_KEY με το πραγματικό σας key. Η αίτηση χρησιμοποιεί το uncensored το model identifier. Αυτό επιβεβαιώνει ότι η authentication και το credit balance σας είναι active.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Επαληθεύστε ότι η απόκριση περιέχει το choices array. Κάθε επιλογή περιλαμβάνει ένα μήνυμα με το παραγόμενο περιεχόμενο. Ελέγξτε το usage αντικείμενο για μετρήσεις tokens. Αυτό σας βοηθά να παρακολουθείτε τις δαπάνες σας με ακρίβεια.

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

Ενσωματώστε το API στις Python εφαρμογές σας χρησιμοποιώντας το επίσημο πακέτο OpenAI. Ορίστε τη βάση URL στο endpoint μας. Αρχικοποιήστε τον πελάτη με το κλειδί API σας. Αυτό σας επιτρέπει να χρησιμοποιείτε εξοικειωμένες μεθόδους όπως chat.completions.create. Το SDK χειρίζεται αυτόματα τη σειριοποίηση JSON και τα HTTP αιτήματα.

Ρυθμίστε το μοντέλο σε uncensored. Δώστε τα μηνύματά σας στον τυπικό τύπο. Το SDK υποστηρίζει όλα μας τα χαρακτηριστικά συμπεριλαμβανομένης της κλήσης συναρτήσεων και της JSON λειτουργίας. Μπορείτε να ορίσετε παραμέτρους όπως temperature και top_p απευθείας. Αυτό κάνει τη μετοίκιση από άλλους παρόχους ευκολότερη.

Copyfrom openai import OpenAI

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

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

Node SDK Integration

Χρησιμοποιήστε το Node.js OpenAI SDK για να ενσωματώσετε έργα JavaScript ή TypeScript. Εγκαταστήστε το πακέτο και ρυθμίστε το base URL. Αυτό διατηρεί τη συμβατότητα με τη δομή του υπάρχοντος κώδικά σας. Μπορείτε να χρησιμοποιήσετε τις ίδιες μεθόδους όπως στη Python. Το SDK υποστηρίζει τόσο CommonJS όσο και ES modules.

Ορίστε το μοντέλο σε uncensored. Δώστε τα μηνύματα και τις παραμέτρους σας. Το SDK χειρίζεται αιτήματα streaming και non-streaming. Μπορείτε να πιάσετε σφάλματα και να τα καταγράψετε κατάλληλα. Αυτό διασφαλίζει ότι η εφαρμογή σας παραμένει σταθερή υπό φόρτο.

Copyimport OpenAI from "openai";

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

Δοκιμάστε την ολοκλήρωση σας με ένα απλό prompt. Επαληθεύστε ότι η απάντηση ταιριάζει με τις προσδοκίες σας. Ελέγξτε τη χρήση tokens στην αντικείμενο απάντησης. Αυτό σας βοηθά να παρακολουθείτε το κόστος και την απόδοση. Το SDK διευκολύνει την γρήγορη επανάληψη.

Streaming Αποκρίσεις και Χρήση Token

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

Ανάλυση των γεγονότων SSE για εξαγωγή του περιεχομένου. Συγκολλήστε τα chunk για να σχηματίσετε την πλήρη απάντηση. Παρακολουθήστε το usage αντικείμενο στο τελευταίο chunk. Αυτό παρέχει ακριβείς μετρήσεις tokens για χρέωση. Η ροή (streaming) είναι ιδανική για εφαρμογές πραγματικού χρόνου.

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)

Διαχειριστείτε διακοπές δικτύου με ευγένεια. Επανασυνδεθείτε αν η ροή διακοπεί. Το API δεν επαναπέμπει προηγούμενα chunks. Πρέπει να ανακατασκευάσετε το πλήρες κείμενο στην πλευρά του πελάτη. Αυτό παρέχει ομαλή εμπειρία χρήστη.

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

Η API μας επιβάλλει αυστηρά όρια για να διασφαλίσει τη σταθερότητα. Μπορείτε να κάνετε 300 αιτήματα ανά λεπτό ανά κλειδί. Έως 8 αιτήματα μπορούν να εκτελεστούν ταυτόχρονα. Το σώμα αιτήματος δεν πρέπει να υπερβαίνει τα 8 MB. Η υπέρβαση αυτών των ορίων οδηγεί σε 429 σφάλμα rate limit. Διαχειριστείτε αυτά τα σφάλματα με exponential backoff.

Το παράθυρο συμφραζομένων είναι 100.000 tokens. Αυτό περιλαμβάνει τόσο την εντολή όσο και την απάντηση. Μέγιστη έξοδος 16.000 tokens ανά αίτηση. Αν δεν ορίσετε max_tokens, προεπιλέγεται σε 2,048. A 401 σφάλμα σημαίνει ότι το κλειδί σας είναι άκυρο. Ένα 402 σφάλμα σημαίνει ότι δεν έχετε υπόλοιπο. Αποθεστε μέσω κρυπτονομίσματος για να συνεχίσετε να χρησιμοποιείτε την υπηρεσία.