Βασικό URL και Αυθεντικοποίηση
Ξεκινήστε κάθε αίτημα κατευθύνοντας τον πελάτη σας στο σωστό base URL. Χρησιμοποιήστε το key που λάβατε κατά την εγγραφή για να το περάσετε στο Authorization header. Αυτό το header πιστοποιεί τον λογαριασμό σας και παρακολουθεί τη χρήση του προκαταβληθέντος υπολοίπου σας.
Η υποδομή μας είναι κατασκευασμένη για προγραμματιστές που θέλουν άμεση πρόσβαση χωρίς τέλη μεσιτείας ενδιάμεσης δρομολόμησης. Λαμβάνετε σταθερή απόδοση επειδή τρέχουμε τους δικούς μας διακομιστές.
Πρώτη αίτηση
Στείλτε το πρώτο μήνυμα για να επαληθεύσετε τη σύνδεση και την απάντηση του μοντέλου. Χρησιμοποιήστε το τυπικό endpoint chat completions με το system prompt και το user query σας. Αυτό επιβεβαιώνει ότι το key σας λειτουργεί και σας δείχνει την ωμή JSON απάντηση.
- Ορίστε το
modelfield γιαuncensored. - Συμπεριλάβετε ένα απλό μήνυμα χρήστη για να δοκιμάσετε την καθυστέρηση.
- Ελέγξτε το
usageαντικείμενο για μετρήσεις tokens.
SDK Python
Ενσωματώστε γρήγορα χρησιμοποιώντας την επίσημη βιβλιοθήκη Python. Εγκαταστήστε το πακέτο και αρχικοποιήστε τον πελάτη με το base URL και το key σας. Αυτή η προσέγγιση διαχειρίζεται τη σειριοποίηση και τις επαναπροσπάθειες αυτόματα.
Ορίστε την ιστορία της συζήτησής σας ως λίστα λεξικών. Δώστε τα απευθείας στο chat endpoint. Η βιβλιοθήκη επιστρέφει ένα δομημένο αντικείμενο απάντησης που μπορείτε να αναλύσετε για το κείμενο του βοηθού.
Node SDK
Δημιουργήστε λογική server-side με το Node.js client. Εισάγετε τη βιβλιοθήκη και διαμορφώστε το API key και το base URL. Αυτή η ρύθμιση λειτουργεί καλά για υπηρεσίες backend που επεξεργάζονται εισόδους χρηστών ασύγχρονα.
Καλέστε τη μέθοδο completion με τα messages σας. Η απόκριση περιλαμβάνει το παραγόμενο κείμενο και στατιστικά χρήσης. Διαχειριστείτε τα σφάλματα με χάρη για να αποφύγετε την κατάρρευση της εφαρμογής σας υπό υψηλό φορτίο.
Streaming Αποκρίσεις
Λάβετε tokens σε πραγματικό χρόνο για πιο ομαλή εμπειρία χρήστη. Ενεργοποιήστε το streaming ρυθμίζοντας την κατάλληλη σημαία στο αίτημά σας. Ο διακομιστής στέλνει chunks δεδομένων καθώς παράγονται.
Συσσωρεύστε αυτά τα chunks στο client-side για να εμφανίσετε το κείμενο προοδευτικά. Αυτό μειώνει σημαντικά την αντιλαμβανόμενη καθυστέρηση. Παρακολουθήστε το τελευταίο chunk για τη συνολική χρήση tokens και τα δεδομένα χρέωσης.
Όρια, Σφάλματα και Context
Σεβαστείτε τα όρια ρυθμού για να αποφύγετε διακοπές. Επιτρέπονται 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες συνδέσεις ανά κλειδί. Εάν τα υπερβείτε, θα λάβετε σφάλμα 429.
Ένα σφάλμα 401 σημαίνει ότι το API key σας είναι μη έγκυρο. Ένα σφάλμα 402 υποδεικνύει ανεπαρκές προκαταβλημένο υπόλοιπο. Το παράθυρο πλαισίου (context window) είναι 100,000 tokens συνολικά. Κρατήστε την εντολή (prompt) και την απόκριση εντός αυτού του ορίου για να διασφαλίσετε αξιόπιστη απόδοση.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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);Ροή
stream = 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)