Βασικό URL και Αυθεντικοποίηση
Χρησιμοποιήστε τη παρεχόμενη βάση URL και ένα έγκυρο API key για να συνδέσετε τον πελάτη σας. Το endpoint είναι https://api.qwencodeapikey.com/v1.Πρέπει να συμπεριλάβετε το key σας στο Authorization header κάθε αίτησης. Αυτό διασφαλίζει ότι η υπηρεσία εντοπίζει σωστά τον λογαριασμό του προπληρωμένου σας πιστωτικού.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Μπορείτε να δημιουργήσετε ένα κλειδί μέσω Google ή email στη σελίδα εγγραφής. Το κλειδί εμφανίζεται αμέσως. Κρατήστε το ασφαλές, καθώς ελέγχει τις δαπάνες σας.
Τερματικό Συμπληρώματος Συζήτησης
Στείλτε μηνύματα στο /v1/chat/completions σημείο τερματισμού (endpoint) για λήψη απαντήσεων κειμένου. Αυτή είναι η τυπική διεπαφή για τα περισσότερα SDKs του OpenAI. Ορίζετε το model ως uncensored and provide a list of messages in the messages array. Το API επεξεργάζεται την είσοδό σας και επιστρέφει μια παραγόμενη συμπλήρωση.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Βεβαιωθείτε ότι η βιβλιοθήκη πελάτη δείχνει στη σωστή βασική διεύθυνση URL. Το ID μοντέλου uncensored επικαλείται το μοντέλο ανοιχτού βάρους που έχει βελτιστοποιηθεί για λιγότερες απορρίψεις. Διαχειρίζεται τις διαδοχικές φάσεις συνομιλίας όπως οποιοδήποτε άλλο chat API.
Τελικό Σημείο Μοντέλων
Ερώτημα GET /v1/models για να επαληθεύσετε τα διαθέσιμα μοντέλα και τις λεπτομέρειές τους. Αυτή η διαδρομή επιστρέφει μια λίστα μοντέλων προσβάσιμων από το κλειδί σας. Βοηθά να επιβεβαιώσετε το uncensored το μοντέλο είναι active και έτοιμο για requests. Χρησιμοποιήστε το για debugging client configurations πριν στείλετε full payloads.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Ελέγξτε τη δομή της απόκρισης για να βεβαιωθείτε ότι το SDK σας αναλύει σωστά τη λίστα μοντέλων. Αυτή η ενότητα δεν καταναλώνει πιστωτική μονάδα, καθιστώντας την ασφαλής για έλεγχο κατά την αρχικοποίηση.
Παράμετροι Αίτησης και Streaming
Υποστηρίζει τυπικές παραμέτρους όπως temperature, top_p, stop, και seed. Ενεργοποιήστε το streaming ορίζοντας stream: true. Η API στέλνει tokens μέσω Server-Sent Events (SSE). Τα στατιστικά χρήσης tokens εμφανίζονται στο τελικό chunk της ροής. Αυτό επιτρέπει την εμφάνιση σε πραγματικό χρόνο του παραγόμενου κειμένου.
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)
Ορίστε max_tokens για τον έλεγχο του μήκους εξόδου. Η προεπιλογή είναι 2.048 tokens. Μπορείτε να το αυξήσετε έως 16.000 tokens ανά αίτηση. Προσαρμόστε τις παραμέτρους για να ισορροπήσετε τη δημιουργικότητα και την ακρίβεια στις απαντήσεις σας.
Όρια Ρυθμού και Περιορισμοί
Κάθε κλειδί επιτρέπει 300 αιτήματα ανά λεπτό και 8 ταυτόχρονα. Το μέγιστο μέγεθος σώματος αιτήματος είναι 8 MB. Τα όρια αυτά αποτρέπουν τη κακοχρήση και εξασφαλίζουν σταθερή απόδοση. Αν ξεπεράσετε το όριο, λαμβάνετε σφάλμα 429. Προσαρμόστε τη λογική του πελάτη σας για χειρισμό επαναπροσπαθειών με εκθετική υποχώρηση.
Το παράθυρο συμφραζομένων υποστηρίζει συνολικά 100.000 tokens. Αυτό περιλαμβάνει τόσο εντολή όσο και ολοκλήρωση. Τα μεγάλα συμφραζόμενα απαιτούν προσεκτική διαχείριση tokens για να παραμείνετε μέσα στα όρια.
Λειτουργία JSON και Κλήση Συναρτήσεων
Χρήση response_format: {"type": "json_object"} για δομημένη έξοδο. Αυτό διασφαλίζει ότι το μοντέλο επιστρέφει έγκυρο JSON, χρήσιμο για προγραμματιστική ενσωμάτωση. Η κλήση συναρτήσεων λειτουργεί μέσω του tools parameter. Ορίστε εργαλεία στη τυπική μορφή OpenAI. Το μοντέλο θα καλεί συναρτήσεις όποτε χρειαστεί.
Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικό. Αυτό ισχύει ακόμη και αν το μοντέλο απορρίψει μια αίτηση λόγω του αυστηρού ορίου περιεχομένου. Πληρώνετε μόνο για την πραγματική χρήση tokens. Το πιστωτικό δεν λήγει ποτέ, οπότε μπορείτε να το пополните όποτε σας βολεύει.
Χειρισμός Σφαλμάτων και Χρήση
Διαχειριστείτε ομαλά τα σφάλματα HTTP. Ένα σφάλμα 401 υποδεικνύει μη έγκυρο ή ληγμένο API key. Ένα σφάλμα 402 σημαίνει ότι το προπληρωμένο credit σας έχει εξαντληθεί. Ένα σφάλμα 429 σηματοδοτεί υπέρβαση ορίου ρυθμού. Ελέγξτε το σώμα της απόκρισης για λεπτομερή μηνύματα σφάλματος.
Η χρήση παρακολουθείται ανά κλειδί. Ένα ενεργό κλειδί ανά λογαριασμό απλοποιεί τη χρέωση. Αν κάνετε λάθος, όπως μια διπλή χρέωση, χρησιμοποιήστε τη σελίδα Υποστήριξης. Το υπόλοιπο δεν επιστρέφεται αλλά παραμένει έγκυρο. Τα σφάλματα είναι δωρεάν, οπότε τα αποτυχημένα αιτήματα δεν εξαντλούν το υπόλοιπό σας.
Συνοψισμός και Βέλτιστες Πρακτικές
Ξεκινήστε με το base URL και ένα έγκυρο κλειδί. Χρησιμοποιήστε το uncensored ID μοντέλου για λιγότερες απορρίψεις. Ροή απαντήσεων για καλύτερη εμπειρία χρήστη. Παρακολουθήστε τα όρια ρυθμού για να αποφύγετε διακοπές. Χρησιμοποιήστε τη λειτουργία JSON για δομημένα δεδομένα. Χειριστείτε σφάλματα για να διατηρήσετε την αξιοπιστία. Το υπόλοιπο είναι προκαταβολικό και δεν λήγει ποτέ. Συμπληρώστε με κρυπτονομίσματα όταν χρειάζεται. Αυτό το API ενσωματώνεται άψογα σε υπάρχοντα codebases OpenAI. Δεν απαιτούνται νέα SDKs. Αλλάξτε απλώς το base URL και το κλειδί.
