Τεκμηρίωση API και Τελικά Σημεία

Authentication and Base URL

Η API απαιτεί ένα έγκυρο key για κάθε αίτημα. Δημιουργείτε αυτό το key άμεσα όταν εγγράφεστε με Google ή διεύθυνση email. Περάστε το key στο Authorization header χρησιμοποιώντας το Bearer σχήμα. Η βάση URL για όλες τις αιτήσεις είναι HTTPS://api.qwenaipricing.com/v1. Αυτό το URL λειτουργεί με τα επίσημα SDK OpenAI και κάθε συμβατό πελάτη απλώς ενημερώνοντας τη βάση διαμόρφωσης.

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

Το κύριο τελικό σημείο είναι POST /v1/chat/completions. Δέχεται ένα σώμα JSON με ένα messages array και ένα model πεδίο. Ορίστε το ID μοντέλου σε "uncensored" για πρόσβαση στο μοντέλο γλώσσας μεγάλου όγκου που έχει ρυθμιστεί για μη περιορισμένες εξόδους. Μπορείτε να ορίσετε ρόλους συστήματος, χρήστη και βοηθού για να δομήσετε το πλαίσιο της συνομιλίας σας.

Copycurl https://api.qwenaipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
  }'

Η απάντηση περιλαμβάνει το παραγόμενο περιεχόμενο, στατιστικά χρήσης και λόγο ολοκλήρωσης. Τα σφάλματα επιστρέφουν τυπικούς κωδικούς HTTP όπως 401 για μη έγκυρα κλειδιά ή 402 αν οι προκαταβλημένες πιστώσεις σας εξαντλήθηκαν. Το API δεν υποστηρίζει ενσωματώσεις, δημιουργία εικόνων ή ενότητες εκπαίδευσης μοντέλων.

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

Χρησιμοποιήστε το επίσημο openai Πακέτο Python για αλληλεπίδραση με την API. Αρχικοποιήστε τον πελάτη παρέχοντας το API key και ορίζοντας το base URL στο endpoint μας. Αυτό σας επιτρέπει να χρησιμοποιήστε εξοικειωμένες μεθόδους όπως chat.completions.create() χωρίς να αναγράψετε ξανά τη λογική του πελάτη. Η βιβλιοθήκη χειρίζεται αυτόματα τη σειριοποίηση JSON και την ανάλυση των αποκρίσεων.

Copyfrom openai import OpenAI

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

Περνάτε τα μηνύματά σας ως λίστα λεξικών (dictionaries). Το SDK υποστηρίζει όλες τις τυπικές παραμέτρους όπως temperature και top_p. Αυτή η προσέγγιση διασφαλίζει συμβατότητα με υπάρχοντα κώδικες που αναμένουν μια διεπαφή συμβατή με OpenAI.

Ενσωμάτωση SDK Node.js

Το Node.js SDK λειτουργεί παρόμοια με την έκδοση Python. Εγκαταστήστε το openai package and configure the base URL and API key. You can then call the chat completions endpoint with your desired parameters. This method is ideal for server-side applications or backend services that need to generate text asynchronously.

Copyimport OpenAI from "openai";

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

Διαχειριστείτε τη ροή απόκρισης ή την υπόσχεση για την επεξεργασία των παραγόμενων tokens. Το SDK διαχειρίζεται τη σύνδεση HTTP και τη διαχείριση σφαλμάτων για εσάς. Μπορείτε επίσης να χρησιμοποιήσετε το GET /v1/models σημείο τερματισμού (endpoint) για επαλήθευση του διαθέσιμου ID μοντέλου.

Ροή και Χρήση

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Το API επιστρέφει μια ροή server-sent events (SSE) μερικών απαντήσεων. Κάθε κομμάτι περιέχει ένα τμήμα του παραγόμενου κειμένου. Αυτό είναι χρήσιμο για διεπαφές χρήστη πραγματικού χρόνου που εμφανίζουν κείμενο καθώς παράγεται.

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)

Το τελευταίο chunk στη ροή περιέχει τη συνολική χρήση tokens για το αίτημα. Μπορείτε να παρακολουθήσετε την κατανάλωση του προκαταβληθέντος πιστωτικού ορίου σας παρακολουθώντας αυτά τα στατιστικά χρήσης. Τα σφάλματα κατά το streaming μπορεί να διακόψουν τη σύνδεση νωρίτερα.

Όρια, Σφάλματα και Context Window

Το μοντέλο υποστηρίζει παράθυρο συνάφειας 100.000 tokens για συνδυασμένη είσοδο και έξοδο. Η μέγιστη έξοδος ανά αίτημα είναι 16.000 tokens. Αν δεν ορίσετε max_tokens, το όριο είναι 2,048 tokens. Περιορίζεστε σε 300 αιτήσεις ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Το σφάλμα 429 υποδεικνύει ότι έχετε ξεπεράσει αυτά τα όρια. Οι αιτήσεις με σφάλματα ή απορρίψεις δεν καταναλώνουν πιστωτικό υπόλοιπο. Το API δεν προσφέρει εγγυήσεις SLA ή πιστοποιήσεις.