Οδηγός Γρήγορης Εκκίνησης API

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

Συνδέστε τον υπάρχοντα OpenAI SDK σας ενημερώνοντας τη βάση URL και παρέχοντας το API key σας. Η υπηρεσία μας βρίσκεται στο https://api.deepseekapidiscount.com/v1 and accepts the standard Authorization: Bearer header. Το κλειδί σας λειτουργεί αμέσως μετά τη δημιουργία του, παρέχοντας πρόσβαση στο μοντέλο χωρίς λογοκρισία χωρίς μηνιαίες συνδρομές. Αυτή η ρύθμιση σας επιτρέπει να αντικαταστήσετε το endpoint μας διατηρώντας τον κώδικα της εφαρμογής σας ακριβώς όπως στα πρότυπα OpenAI.

Η ροή πιστοποίησης είναι απλή. Δημιουργείτε ένα key στο dashboard μας και το περνάτε ως header. Σφάλματα όπως 401 υποδηλώνουν ένα άκυρο key, ενώ 402 σημαίνει ότι το προπληρωμένο σας credit εξαντλήθηκε. Μπορείτε να пополните μέσω USDT ή USDC οποιαδήποτε στιγμή, και το credit σας δεν λήγει ποτέ. Αυτό το προπληρωμένο μοντέλο διασφαλίζει ότι πληρώνετε μόνο για τα tokens που χρησιμοποιείτε πραγματικά, χωρίς κρυφά κόστη ή όρια επιπέδων.

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

Στείλτε το πρώτο σας αίτημα στο /v1/chat/completions σημείο τερματισμού (endpoint) χρησιμοποιώντας το ID μοντέλου uncensored. Αυτό το endpoint διαχειρίζεται αλληλεπιδράσεις text-in, text-out χωρίς ενσωματωμένη content moderation. Μπορείτε να ελέγξετε το στυλ απάντησης χρησιμοποιώντας παραμέτρους όπως temperature και top_p. Το μοντέλο υποστηρίζει παράθυρο πλαισίου 100.000 tokens, επιτρέποντας εκτεταμένη ιστορία συνομιλίας ή επεξεργασία εγγράφων σε ένα μόνο αίτημα. Η μέγιστη έξοδος ορίζεται στα 16.000 tokens ανά αίτημα, ή 2.048 αν παραλείψετε το όριο.

• Χρήση response_format με json_object για έξοδο δομημένων δεδομένων.
• Ορίστε stream: true για παράδοση token σε πραγματικό χρόνο.
• Περνάω stop ακολουθίες για να διακόψετε τη δημιουργία σε συγκεκριμένους δείκτες.

Αυτό το endpoint είναι ο πυρήνας του API μας, σχεδιασμένο για προγραμματιστές που χρειάζονται ωμά, μη φιλτραρισμένα αποτελέσματα μοντέλου. Δεν προσφέρει embeddings ή παραγωγή εικόνας, κρατώντας την υπηρεσία εστιασμένη και οικονομική. Πληρώνετε $0.15 ανά εκατομμύριο tokens εισόδου και $0.50 ανά εκατομμύριο tokens εξόδου. Τα σφάλματα δεν καταναλώνουν το credit σας, οπότε μπορείτε να δοκιμάζετε ελεύθερα χωρίς να ανησυχείτε για σπατάλη χρημάτων.

Ροή και Χρήση Tokens

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

Το αντικείμενο χρήσης token περιλαμβάνει input tokens, output tokens και μερικές φορές total tokens. Επειδή το API μας είναι προπληρωμένο, μπορείτε να παρακολουθείτε το υπόλοιπο πιστωτικού σας έναντι αυτών των αριθμών χρήσης. Τα σφάλματα κατά τη ροή (streaming) δεν χρεώνουν για τα tokens που έχουν ήδη σταλεί. Αυτή η διαφάνεια σας βοηθά να διαχειριστείτε τον προϋπολογισμό σας αποτελεσματικά, ειδικά όταν εκτελείτε μακρές συνομιλίες ή επεξεργάζεστε μεγάλα έγγραφα. Το παράθυρο context 100,000 tokens υποστηρίζει βαθιο ιστορικό context χωρίς περικοπή.

Function Calling και JSON Mode

Χρησιμοποιήστε κλήση συναρτήσεων για να ενσωματώσετε το API μας σε ροές εργασίας agent. Ορίστε τα εργαλεία σας στο tools parameter και ορίστε tool_choice για auto ή ένα συγκεκριμένο ID συνάρτησης. Το μοντέλο θα επιστρέψει ένα αντικείμενο tool call αν η είσοδος απαιτεί εξωτερική δράση. Αυτή η λειτουργία λειτουργεί παράλληλα με το JSON mode, το οποίο αναγκάζει την έξοδο σε ένα αυστηρό JSON schema χρησιμοποιώντας response_format. Μπορείτε να συνδυάσετε αυτά για ισχυρή εξαγωγή δομημένων δεδομένων.

Η κλήση συναρτήσεων υποστηρίζει πολλαπλά εργαλεία σε ένα μόνο αίτημα. Το μοντέλο αποφασίζει ποιο εργαλείο να χρησιμοποιήσει με βάση το πλαίσιο εισόδου. Η λειτουργία JSON είναι χρήσιμη όταν χρειάζεστε προβλέψιμες δομές δεδομένων για επεξεργασία σε επόμενα στάδια. Και τα δύο χαρακτηριστικά διατίθενται στην ίδια βασική τιμή των $0.15 ανά εκατομμύριο tokens εισόδου. Αυτή η ευελιξία καθιστά το API μας κατάλληλο για σύνθετες εφαρμογές που απαιτούν ακριβή μορφοποίηση εξόδου.

Όρια και Βέλτιστες Πρακτικές

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

Οι βέλτιστες πρακτικές περιλαμβάνουν τον ορισμό ενός max_tokens όριο για τον έλεγχο του κόστους και την αποφυγή άπειρης παραγωγής. Χρησιμοποιήστε stop ακολουθίες για την πρόληψη της περιπλάνησης του μοντέλου. Παρακολουθήστε τη χρήση των tokens σας μέσω της διαδρομής streaming για να παραμείνετε εντός του προκαταβλητέου πιστωτικού σας ορίου. Επειδή το πιστωτικό σας ποσό δεν λήγει, μπορείτε να το пополните όποτε σας βολεύει. Το μοντέλο uncensored δεν αρνείται νόμιμο περιεχόμενο για ενήλικες, αλλά θα αποκλείσει το σεξουαλικό περιεχόμενο που αφορά ανηλίκους. Αυτό το αυστηρό όριο ισχύει ανεξάρτητα από το επίπεδο του λογαριασμού σας.

Παραδείγματα πελατών

Ακολουθούν αποσπάσματα κώδικα για δημοφιλείς γλώσσες. Χρησιμοποιήστε τα επίσημα SDK της OpenAI ή οποιοδήποτε συμβατό client. Αντικαταστήστε YOUR_API_KEY με το παραγόμενο key σας. Το base URL είναι https://api.deepseekapidiscount.com/v1. Αυτά τα παραδείγματα δείχνουν βασική παραγωγή κειμένου και streaming. Μπορείτε να τα προσαρμόσετε στην συγκεκριμένη περίπτωσή σας, είτε πρόκειται για chat, σύνοψη ή εξαγωγή δεδομένων.

cURL

Copycurl https://api.deepseekapidiscount.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status for uptime reliability and latency metrics"}]
  }'

Python

Copyfrom openai import OpenAI

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