Τεκμηρίωση API Συμβατό με OpenAI

Πιστοποίηση και Ρύθμιση Base URL

Το API key σας ταυτοποιεί κάθε αίτηση προς τους διακομιστές μας. Απλώς εγγραφείτε με Google ή μια διεύθυνση email και αντιγράψτε το κλειδί από το dashboard σας. Επικολλήστε το στη μεταβλητή περιβάλλοντος ως DEEPSEEK_API_KEY και κατευθύνετε τον πελάτη σας στο https://api.keyapideepseek.com/v1. Αυτή η βάση URL λειτουργεί με οποιαδήποτε τυπική βιβλιοθήκη συμβατή με OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Μπορείτε να επαληθεύσετε τη ρύθμισή σας καταγράφοντας τα διαθέσιμα μοντέλα. Η απάντηση επιβεβαιώνει ότι το key σας είναι έγκυρο και ενεργό. Αυτό το βήμα διασφαλίζει ότι η ενσωμάτωσή σας δείχνει στο σωστό uncensored endpoint πριν στείλετε prompts.

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

"Το POST /v1/chat/completions το σημείο τέλους δέχεται την προτροπή σας και επιστρέφει την απόκριση του μοντέλου. Στέλνετε ένα σώμα JSON που περιέχει μηνύματα, τις οδηγίες συστήματός σας και παραμέτρους όπως η θερμοκρασία. Το id του μοντέλου είναι πάντα uncensored.Αυτό το μοναδικό μοντέλο διαχειρίζεται όλες τις ανάγκες δημιουργίας κειμένου σας χωρίς πολυπλοκότητα δρομολόγησης.

Copyfrom openai import OpenAI

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

Το SDK Python διαχειρίζεται αυτόματα τις HTTP αιτήσεις. Δίνετε το key και τη βάση URL στο κατασκευαστή του πελάτη. Το υπόλοιπο κώδικα αντανακλά τα τυπικά μοτίβα OpenAI. Αυτό διασφαλίζει ότι μπορείτε να αλλάξετε παρόχους αργότερα χωρίς να ξαναγράψετε όλη τη λογική της εφαρμογής σας.

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

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

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) μειώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες. Μπορείτε να εμφανίζετε tokens καθώς φτάνουν. Αυτό είναι κρίσιμο για παραγωγή μακροσκελούς κειμένου ή διαδραστικές διεπαφές συνομιλίας. Παρακολουθήστε τη χρήση tokens στο τελευταίο κομμάτι για να παρακολουθείτε με ακρίβεια την κατανάλωση του προκαταβλητέου πιστωτικού σας ορίου.

Λειτουργία JSON και Κλήση Συναρτήσεων

Επιβάλετε δομημένη έξοδο ρυθμίζοντας response_format για {"type": "json_object"}. Το μοντέλο θα επιστρέψει έγκυρο JSON αντί για ελεύθερο κείμενο. Αυτό είναι ιδανικό για ενσωματώσεις API ή εργασίες εξαγωγής δεδομένων. Μπορείτε επίσης να ορίστε ορισμούς συναρτήσεων στην εντολή σας για χρήση εργαλείων.

Το μοντέλο υποστηρίζει tool_choice parameters. Μπορείτε να αναγκάσετε συγκεκριμένες συναρτήσεις ή να αφήσετε το μοντέλο να αποφασίσει. Αυτή η ευελιξία σας επιτρέπει να κατασκευάσετε σύνθετα agents. Βεβαιωθείτε ότι τα schemas των συναρτήσεών σας είναι αυστηρά typed για να αποφύγετε σφάλματα parsing στον client κώδικά σας.

Όρια Ρυθμού και Συνάφεια

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

Υλοποιήστε εκθετική υποχώρηση (exponential backoff) στον κώδικα του πελάτη σας. Επαναλάβετε τα αποτυχημένα αιτήματα μετά από μια μικρή καθυστέρηση. Αυτό διαχειρίζεται παροδικά δικτυακά προβλήματα με χάρη. Το προπληρωμένο πιστωτικό σας υπόλοιπο χρεώνεται μόνο για επιτυχημένες ολοκληρώσεις, όχι για επαναλήψεις λόγω ορίων ρυθμού.

Χειρισμός Σφαλμάτων και Απορρίψεις

Ένα σφάλμα 401 σημαίνει ότι το key σας είναι μη έγκυρο ή ληγμένο. Ένα σφάλμα 402 υποδεικνύει ανεπαρκές προκαταβλημένο υπόλοιπο. Ένα σφάλμα 429 σηματοδοτεί ότι έχετε χτυπήσει το όριο ταχύτητας. Το μοντέλο απορρίπτει αιτήσεις που περιέχουν σεξουαλικό περιεχόμενο που αφορά ανηλίκους. Όλο το άλλο νόμιμο περιεχόμενο ενηλίκων επιτρέπεται.

Ελέγξτε το σώμα της απόκρισης σφάλματος για αναλυτικά μηνύματα. Καταγράψτε αυτά τα σφάλματα για τον εντοπισμό προβλημάτων ενσωμάτωσης. Το credit σας δεν καταναλώνεται για αποτυχημένα αιτήματα. Αυτό το διαφανές μοντέλο χρέωσης σας βοηθά να προβλέψετε τα κόστη ακριβώς χωρίς κρυφές χρεώσεις.

Node.js

Copyimport OpenAI from "openai";

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