Εγκατάσταση του Επίσημου SDK
Ξεκινήστε εγκαθιστώντας το επίσημο Python SDK της OpenAI στο περιβάλλον σας. Αυτή η βιβλιοθήκη διαχειρίζεται τα αιτήματα HTTP και τη σειριοποίηση JSON για εσάς.
- Τρέξιμο
pip install openaiστο τερματικό σας. - Βεβαιωθείτε ότι χρησιμοποιείτε μια πρόσφατη έκδοση της βιβλιοθήκης.
Αυτή η μοναδική εξάρτηση σας δίνει πρόσβαση στο τυπικό interface πελάτη που χρησιμοποιείται σε όλη την βιομηχανία.
Ρύθμιση Βασικής URL και Κλειδιού
Κατευθύνετε τον πελάτη σας στη βάση URL μας και ορίστε το API key σας για πιστοποίηση. Αυτό διασφαλίζει ότι όλα τα αιτήματα κατευθύνονται στον server του μοντέλου μας χωρίς λογοκρισία.
Χρήση https://api.qwenmaxapi.com/v1 ως τη βάση URL. Δημιουργήστε το κλειδί σας στο Get API key σελίδα μέσω Google ή email. Το κλειδί εμφανίζεται αμέσως μετά την εγγραφή.
Στείλτε την Πρώτη Αίτηση Chat Completion
Στείλτε ένα απλό κειμενικό αίτημα στο /v1/chat/completions endpoint. Το model επιστρέφει unrestricted text βασισμένο στο prompt σας.
Χρησιμοποιήστε το Model ID uncensored. Το API δέχεται τυπικές παραμέτρους όπως temperature και top_p. Μπορείτε να προσαρμόσετε αυτά για να ελέγξετε τη δημιουργικότητα.
Ενεργοποίηση Streaming και Χειρισμός Token
Ενεργοποιήστε τη ροή (streaming) για να λαμβάνετε tokens καθώς παράγονται. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροσκελείς απαντήσεις.
Ορίστε stream=True στην αίτησή σας. Ο διακομιστής στέλνει Server-Sent Events (SSE). Οι λεπτομέρειες χρήσης tokens εμφανίζονται στο τελικό τμήμα.
Διαχειριστείτε τη ροή στον κώδικά σας για να εμφανίσετε την έξοδο προοδευτικά.
Δοκιμή Λειτουργίας JSON και Κλήσης Λειτουργιών
Χρησιμοποιήστε JSON mode για έξοδο δομημένων δεδομένων. Ορίστε response_format για {"type": "json_object"}. Αυτό εξασφαλίζει ότι το μοντέλο επιστρέφει έγκυρο JSON.
Ενεργοποίηση κλήσης λειτουργιών παρέχοντας ένα tools definition. The model can invoke tools based on your prompt context. Use tool_choice για να επιβληθεί ή να επιτραπεί η χρήση εργαλείων.
Όρια, Σφάλματα και Context Window
Know your limits before scaling your integration. The context window is 100,000 tokens total.
Η μέγιστη έξοδος ανά αίτημα είναι 16.000 tokens. Λαμβάνετε 300 αιτήματα ανά λεπτό ανά κλειδί. Επιτρέπονται οκτώ ταυτόχρονες αιτήσεις ανά κλειδί.
Διαχειριστείτε σφάλματα όπως 401 για μη έγκυρα κλειδιά ή 402 για ανεπαρκές υπόλοιπο. Τα σφάλματα είναι δωρεάν, οπότε οι λανθασμένες αιτήσεις δεν καταναλώνουν υπόλοιπο.
cURL
curl https://api.qwenmaxapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 arguments against cloud computing"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenmaxapi.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenmaxapi.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);Ροή
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)