Τεκμηρίωση API και Γρήγορη Εκκίνηση

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

Η base URL για όλες τις αιτήσεις είναι https://api.veniceaiapipricing.com/v1. Κάνετε έλεγχο ταυτότητας περνώντας το API key σας στο Authorization header ως bearer token. Αυτή η ρύθμιση λειτουργεί με οποιοδήποτε τυπικό SDK OpenAI. Αντικαταστήστε YOUR_API_KEY με το κλειδί που δημιουργήθηκε από το dashboard του λογαριασμού σας.

• Τερματικό σημείο: POST /v1/chat/completions
• Header: Authorization: Bearer YOUR_API_KEY

Copycurl https://api.veniceaiapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return server status code 200"}]
  }'

Το Endpoint /v1/chat/completions

Στείλτε την ιστορία συνομιλίας σας στο /v1/chat/completions χρησιμοποιώντας το uncensored το ID του μοντέλου. Το API δέχεται τυπικά αντικείμενα μηνυμάτων με role και content πεδία. Τα tokens εισόδου κοστίζουν $0.15 ανά εκατομμύριο, και τα tokens εξόδου κοστίζουν $0.50 ανά εκατομμύριο. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν πιστωτικό υπόλοιπο.

Αυτό το endpoint υποστηρίζει παραγωγή κειμένου μόνο. Δεν διαχειρίζεται εικόνες, ήχο ή embeddings. Μπορείτε να ροοποιήσετε τις απαντήσεις ή να ανακτήσετε το πλήρες κείμενο σε ένα μοναδικό αντικείμενο JSON.

Copyfrom openai import OpenAI

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

Streaming Αποκρίσεις (SSE)

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

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

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)

Function Calling και JSON Mode

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

Αυτή η λειτουργία είναι χρήσιμη για την εξαγωγή δεδομένων ή την ενεργοποίηση ενεργειών. Το μοντέλο επιστρέφει κλήσεις εργαλείων σε τυποποιημένη μορφή. Στη συνέχεια, μπορείτε να εκτελέσετε τις συναρτήσεις σας και να τροφοδοτήσετε τα αποτελέσματα πίσω στη συζήτηση.

Παράμετροι: Θερμοκρασία, Top P, Seeds

Ελέγξτε τη δημιουργικότητα με temperature και top_p. Το seed parameter διασφαλίζει deterministic εξόδους για testing. Αυτά τα parameters ακολουθούν τα τυπικά standards OpenAI. Η προσαρμογή τους επηρεάζει την τυχαιότητα του παραγόμενου κειμένου.

Ορίστε temperature σε 0.7 για ισορροπημένη δημιουργικότητα. Χρησιμοποιήστε seed για αναπαραγώγιμα αποτελέσματα. Το API αγνοεί ευγενικά τις μη υποστηριζόμενες παράμετρους.

Όρια Ρυθμού και Περιορισμοί

Είστε περιορισμένοι σε 300 αιτήσεις ανά λεπτό ανά κλειδί. Επιτρέπεται μέγιστο 8 ταυτόχρονες αιτήσεις ανά κλειδί. Το μέγεθος του σώματος της αίτησης περιορίζεται στα 8 MB. Το παράθυρο πλαισίου είναι 100.000 tokens για είσοδο και έξοδο συνολικά. Η μέγιστη έξοδος ανά αίτηση είναι 16.000 tokens.

Η υπέρβαση αυτών των ορίων επιστρέφει σφάλμα 429. Βεβαιωθείτε ότι ο πελάτης σας χειρίζεται τις επαναλήψεις κατάλληλα. Το κλειδί API είναι μοναδικό ανά λογαριασμό· η δημιουργία νέου κλειδιού αντικαθιστά το παλιό.

Node.js

Copyimport OpenAI from "openai";

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