Οδηγός Ενσωμάτωσης για Προγραμματιστές

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

Ξεκινήστε κατευθύνοντας τον πελάτη σας στη βάση URL μας και παρέχοντας το API key σας στην κεφαλίδα authorization. Αυτό λειτουργεί με οποιοδήποτε OpenAI-compatible SDK επειδή ακολουθούμε το τυπικό πρωτόκολλο ακριβώς όπως ορίζεται. Δημιουργήστε το κλειδί σας ακαριαία μέσω Google ή email στη σελίδα Get API key· δεν απαιτείται αριθμός τηλεφώνου. Διατηρήστε το κλειδί σας ασφαλές και χρησιμοποιήστε ένα ενεργό κλειδί ανά λογαριασμό, καθώς η δημιουργία ενός νέου αντικαθιστά το παλιό.

Η πιστοποίηση είναι απλή. Στείλτε το key σας στο Authorization header για κάθε αίτηση. Το σύστημά μας ελέγχει το κλειδί πριν επεξεργαστεί tokens, διασφαλίζοντας ότι μόνο οι εξουσιοδοτημένοι λογαριασμοί καταναλώνουν πιστωτικό. Σφάλματα όπως λείπον κλειδί επιστρέφουν αμέσως κατάσταση 401.

Πρώτη αίτηση

Στείλτε ένα τυπικό αίτημα chat completion για να δοκιμάσετε τη σύνδεση και την ποιότητα απάντησης. Αυτή η απλή κλήση επαληθεύει το key σας και χρεώνει σωστά το λογαριασμό σας. Το model id είναι uncensored, το οποίο χειρίζεται εισόδους και εξόδους κειμένου χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενήλικων. Αντικαταστήστε το placeholder με το πραγματικό σας κλειδί και το system prompt.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

Αυτή η εντολή curl δείχνει τη ελάχιστη δομή που απαιτείται. Μπορείτε να προσαρμόσετε το messages array για να συμπεριλάβετε πλαίσιο ή οδηγίες. Η απόκριση επιστρέφει το παραγόμενο κείμενο στο content πεδίο. Ελέγξτε τα στατιστικά χρήσης στις κεφαλίδες της απόκρισης για να παρακολουθείτε την κατανάλωση tokens.

SDK Python

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για να ενσωματώσετε το API μας στα scripts ή τις εφαρμογές σας. Ορίστε το base_url και api_key attributes πριν κάνετε κλήσεις. Αυτή η προσέγγιση διασφαλίζει συμβατότητα με υπάρχοντα codebases που χρησιμοποιούν ήδη μοντέλα OpenAI. Μπορείτε να εναλλάξετε μεταξύ παρόχων αλλάζοντας μόνο δύο γραμμές διαμόρφωσης.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapicost.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 snippet παραπάνω δείχνει πώς να αρχικοποιήσετε τον πελάτη και να στείλετε ένα αίτημα. Η βιβλιοθήκη διαχειρίζεται αυτόματα τη σειριοποίηση JSON και την ανάλυση απόκρισης. Μπορείτε να προσπελάσετε το αντικείμενο απόκρισης για να εξαγάγετε περιεχόμενο, στατιστικά χρήσης και λόγους ολοκλήρωσης. Αυτή η μέθοδος είναι ιδανική για backend υπηρεσίες ή pipelines επεξεργασίας δεδομένων.

Node SDK

Ενσωματώστε το API μας σε εφαρμογές Node.js χρησιμοποιώντας το openai πακέτο npm. Διαμορφώστε τον πελάτη με το base URL μας και το κλειδί API σας ακριβώς όπως θα κάνατε για το OpenAI. Αυτό σας επιτρέπει να χρησιμοποιείτε την ίδια δομή κώδικα τόσο για δοκιμές όσο και για παραγωγή. Το SDK υποστηρίζει ασύγχρονες λειτουργίες για μη αποκλειστικές αιτήσεις.

Copyimport OpenAI from "openai";

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

Αυτό το παράδειγμα Node.js δείχνει την αποστολή μιας αίτησης chat completion. Το await keyword διασφαλίζει ότι η απάντηση λαμβάνεται πλήρως πριν προχωρήσει. Μπορείτε να χειριστείτε σφάλματα χρησιμοποιώντας try-catch blocks για να διαχειριστείτε προβλήματα δικτύου ή όρια API με χάρη. Το αντικείμενο απάντησης περιέχει το παραγόμενο κείμενο και λεπτομέρειες χρήσης tokens.

Ροή

Ενεργοποιήστε τη ροή για λήψη απαντήσεων token ανά token για καλύτερη εμπειρία χρήστη σε διεπαφές συνομιλίας. Ορίστε το stream parameter to true in your request. The API returns chunks of text as they are generated, allowing you to display output in real time. This reduces perceived latency for end-users significantly.

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)

Ο παραπάνω κώδικας streaming επεξεργάζεται κάθε chunk καθώς αυτό φτάνει. Μπορείτε να προσθέσετε το περιεχόμενο σε ένα στοιχείο UI αμέσως. Το τελευταίο chunk περιέχει τα στατιστικά συνολικής χρήσης tokens. Αυτή η λειτουργία υποστηρίζεται από όλους τους OpenAI-compatible πελάτες που διαχειρίζονται σωστά τις αποκρίσεις SSE.

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

Η API μας επιβάλλει αυστηρά όρια για να διασφαλίσει δίκαιη χρήση και σταθερότητα συστήματος. Επιτρέπονται 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Κάθε σώμα αιτήματος δεν πρέπει να υπερβαίνει τα 8 MB. Αν ξεπεράσετε αυτά τα όρια, η API επιστρέφει κωδικό κατάστασης 429. Περιμένετε λίγα δευτερόλεπτα και επαναπροσπαθήστε με το αίτημά σας. Σφάλματα όπως τα μη έγκυρα κλειδιά επιστρέφουν 401, και το ανεπαρκές υπόλοιπο επιστρέφει 402.

Το παράθυρο συμφραζομένων υποστηρίζει έως 100,000 tokens για είσοδο και έξοδο συνδυαστικά. Η μέγιστη έξοδος ανά αίτημα είναι 16,000 tokens, ή 2,048 αν δεν καθορίσετε max_tokens. Αυτό το μεγάλο παράθυρο σας επιτρέπει να επεξεργάζεστε μακροσκελή έγγραφα ή να διατηρείτε εκτεταμένη ιστορικό συνομιλίας χωρίς περικοπή. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικό υπόλοιπο, οπότε πληρώνετε μόνο για την πραγματική χρήση.