Τεκμηρίωση API για Προγραμματιστές

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

Ξεκινήστε αλλάζοντας το base URL στο dedikated endpoint μας και περνώντας το API key σας στον header Authorization. Δεν χρησιμοποιούμε το τυπικό base URL του OpenAI; πρέπει να κατευθύνετε το SDK σας στο https://api.deepseektokenplan.com/v1. Αυτό εξασφαλίζει ότι τα αιτήματά σας διακινούνται μέσω της υποδοχής μας με το μοντέλο χωρίς λογοκρισία. Το αναγνωριστικό μοντέλου που καθορίζετε στο σώμα του αιτήματος είναι "uncensored", το οποίο ενεργοποιεί τα εξειδικευμένα βάρη στους διακομιστές μας. Η πιστοποίηση βασίζεται σε ένα απλό σχήμα Bearer token που λειτουργεί με οποιαδήποτε βιβλιοθήκη συμβατή με το OpenAI. Το κλειδί σας δημιουργείται άμεσα κατά την εγγραφή μέσω Google ή email, χωρίς να απαιτείται αριθμός τηλεφώνου. Διατηρήστε αυτό το κλειδί ασφαλές, καθώς συνδέεται άμεσα με το υπόλοιπο του προπληρωμένου σας πιστωτικού λογαριασμού.

Πρώτη αίτηση

Στείλτε μια τυπική αίτηση ολοκλήρωσης συνομιλιών χρησιμοποιώντας cURL για να επαληθεύσετε τη ρύθμισή σας και τη διαθεσιμότητα του μοντέλου. Αυτή η απλή αίτηση POST δείχνει πώς το API δέχεται την εντολή συστήματος και το μήνυμα χρήστη. Μπορείτε να προσαρμόσετε τις παραμέτρους temperature και top_p για να ελέγξετε τη δημιουργικότητα. Η απάντηση επιστρέφει το παραγόμενο κείμενο μαζί με στατιστικά χρήσης tokens για διαφάνεια στις χρεώσεις. Βεβαιωθείτε ότι το σώμα της αίτησής σας περιλαμβάνει το σωστό αναγνωριστικό μοντέλου και το API key σας στην κεφαλίδα. Αυτή η μέθοδος λειτουργεί τόσο για παραγωγή κειμένου όσο και για κλήση συναρτήσεων. Χρησιμοποιήστε αυτή την εντολή για να επιβεβαιώσετε τη σύνδεση πριν ενσωματώσετε την εφαρμογή. Το endpoint υποστηρίζει τόσο streaming όσο και non-streaming λειτουργίες εξίσως καλά.

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

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για αλληλεπίδραση με το API μας ρυθμίζοντας τη βάση URL και το API key. Αρχικοποιήστε τον πελάτη με τα διαπιστευτήριά σας και καλέστε τη μέθοδο chat completions με το επιθυμητό ID μοντέλου. Αυτή η προσέγγιση σας επιτρέπει να αξιοποιήσετε υπάρχοντα repos κώδικα που χτίστηκαν για την OpenAI χωρίς μεγάλη αναδιάρθρωση. Μπορείτε να κάνετε streaming απαντήσεων ή να λάβετε το πλήρες κείμενο ταυτόχρονα. Η βιβλιοθήκη χειρίζεται τη σειριοποίηση JSON και τα αιτήματα HTTP αυτόματα. Ρυθμίστε τις ρυθμίσεις timeout και retry ανάλογα με την συγκεκριμένη περίπτωσή σας. Αυτή η μέθοδος είναι ιδανική για υπηρεσίες backend και αγωγούς επεξεργασίας δεδομένων. Βεβαιωθείτε ότι ενημερώνετε τη βάση URL ώστε να δείχνει στο συγκεκριμένο endpoint μας.

Node SDK Integration

Ενσωματώστε το API στις εφαρμογές JavaScript ή TypeScript σας χρησιμοποιώντας το πακέτο Node του OpenAI. Ορίστε το base URL και το API key στη διαμόρφωση του πελάτη πριν κάνετε οποιαδήποτε αίτηση. Αυτή η ρύθμιση σας επιτρέπει να χρησιμοποιείτε γνωστές μεθόδους όπως chat.completions.create() με το uncensored μοντέλο μας. Μπορείτε να περάσετε παραμέτρους όπως temperature και stop sequences για να βελτιστοποιήσετε την έξοδο. Το SDK χειρίζεται αποδοτικά τις streaming responses για real-time εφαρμογές. Χρησιμοποιήστε αυτή τη μέθοδο για web servers ή command-line tools. Βεβαιωθείτε ότι έχετε εισάγει τα απαραίτητα modules και διαμορφώσετε σωστά τις μεταβλητές περιβάλλοντος. Αυτή η μέθοδος υποστηρίζει τόσο synchronous όσο και asynchronous patterns requests.

Ροή και Tokens

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

Όρια και Διαχείριση Σφαλμάτων

Παρακολουθήστε τα όρια ρυθμού και χειριστείτε τα σφάλματα με χάρη για να διασφαλίσετε μια σταθερή σύνδεση. Η API επιτρέπει 300 αιτήσεις ανά λεπτό ανά κλειδί και 8 ταυτόχρονες αιτήσεις. Κάθε σώμα αιτήματος δεν πρέπει να υπερβαίνει τα 8 MB. Αν στείλετε μη έγκυρο κλειδί, θα λάβετε σφάλμα 401 Unauthorized. Ένα σφάλμα 402 υποδηλώνει ανεπαρκές προπληρωμένο πιστωτικό, απαιτώντας προσθήκη κεφαλαίων μέσω κρυπτονομίσματος. Ένα σφάλμα 429 σημαίνει ότι έχετε υπερβεί το όριο ρυθμού·περιμένετε και δοκιμάστε ξανά. Το παράθυρο πλαισίου είναι 100,000 tokens για prompt και ολοκλήρωση συνδυαστικά. Μέγιστη έξοδος 16,000 tokens εκτός αν ορίσετε χαμηλότερο max_tokens value. Ελέγξτε πάντα το status code και το response body για λεπτομερή μηνύματα σφάλματος.

cURL

Copycurl https://api.deepseektokenplan.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 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Ροή

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)