Οδηγός Ενσωμάτωσης για Προγραμματιστές

Πιστοποίηση και ρύθμιση base URL

Ξεκινήστε δημιουργώντας το κλειδί API σας στον πίνακα ελέγχου. Η βασική διεύθυνση URL είναι HTTPS://api.apiaicheap.com/v1. Στείλτε το κλειδί σας στην κεφαλίδα Authorization ως bearer token.

• Κάντε κλικ στο "Λήψη κλειδιού API" και συνδεθείτε με Google ή email.
• Αντιγράψτε το key αμέσως· εμφανίζεται μόνο μία φορά.

Αυτό το κλειδί πιστοποιεί όλες τις αιτήσεις στην ενότητα chat completions.

Παράδειγμα Κεφαλίδας

Εξουσιοδότηση: Bearer YOUR_API_KEY

Πρώτη αίτηση με cURL

Στείλτε μια βασική chat completion για να ελέγξετε τη ρύθμισή σας. Χρησιμοποιήστε το endpoint POST /v1/chat/completions με το μοντέλο "uncensored".

Αυτό επιβεβαιώνει το υπόλοιπο πιστωτικού σας λογαριασμού και την καθυστέρηση.

• Ορίστε τον ρόλο σε "user".
• Κρατήστε το μήνυμα απλό για το πρώτο τεστ.

Ελέγξτε την απόκριση για μια ανακτήθηκε περιοχή κειμένου.

• Αναζητήστε την τιμή "content".

Αν λάβετε 200 OK, η ενσωμάτωσή σας λειτουργεί.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

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

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για εύκολη ενσωμάτωση. Κατευθύνετέ την στη βάση URL μας και ορίστε το API key σας.

Αυτή η προσέγγιση διαχειρίζεται αυτόματα τις επαναπροσπαθείες και την ανάλυση JSON.

• Εγκαταστήστε τη βιβλιοθήκη μέσω pip.
• Ορίστε την παράμετρο base_url στο σημείο άφιξής μας.

Καλέστε τη μέθοδο chat.completions.create.

Περνάτε τη λίστα μηνυμάτων σας ως όρισμα.

• Συμπεριλάβετε το όνομα μοντέλου "uncensored".

Πρόσβαση στο κείμενο απόκρισης μέσω των χαρακτηριστικών του αντικειμένου.

Αυτή η μέθοδος είναι καθαρή και ευανάγνωστη για scripts παραγωγής.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiaicheap.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 Node.js

Το Node.js SDK λειτουργεί παρόμοια με την έκδοση Python. Αρχικοποιήστε τον πελάτη με το key σας και τη βάση URL μας.

Αυτό σας επιτρέπει να χρησιμοποιήσετε familiar patterns async/await.

• Εισάγετε το πακέτο OpenAI.
• Ρυθμίστε τη βάση URL στον κατασκευαστή.

Δημιουργήστε ένα αίτημα ολοκλήρωσης με τα μηνύματά σας.

Διαχειριστείστε την υπόσχεση (promise) για να λάβετε το αποτέλεσμα.

• Εξάγετε το περιεχόμενο του μηνύματος από την απόκριση.

Καταγράψτε την έξοδο για να επαληθεύσετε ότι το μοντέλο απαντά σωστά.

Αυτή η ρύθμιση είναι ιδανική για web servers και backend υπηρεσίες.

Copyimport OpenAI from "openai";

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

Ροή αποκρίσεων με SSE

Ενεργοποιήστε τη ροή (streaming) ορίζοντας stream σε true στη διεπαφή σας. Η API επιστρέφει chunks καθώς παράγονται μέσω Server-Sent Events.

Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες σε εφαρμογές chat.

• Ορίστε stream: true στο payload.
• Επεξεργαστείτε κάθε τμήμα καθώς φτάνει.

Συνδυάστε τα τμήματα για να σχηματίσετε την τελική απάντηση.

Τα λεπτομερή δεδομένα χρήσης token εμφανίζονται στο τελευταίο chunk.

• Ελέγξτε το πεδίο "usage" στο τελικό chunk.

Αυτή η προσέγγιση διατηρεί το διεπαφή χρήστη ανταποκρινόμενο κατά τη διάρκεια μακρών διαδικασιών δημιουργίας.

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)

Όρια, σφάλματα και context window

Ο λογαριασμός σας έχει όριο 300 αιτήσεων ανά λεπτό ανά key. Το context window υποστηρίζει 100,000 tokens συνολικά για prompt και completion.

Τα σφάλματα διαχειρίζονται με τυπικούς κωδικούς κατάστασης HTTP.

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

Οι απορρίψεις δεν κοστίζουν credit. Τα σφάλματα είναι επίσης δωρεάν.

Η μέγιστη έξοδος είναι 16,000 tokens ανά αίτημα. Ορίστε το max_tokens αν χρειάζεστε λιγότερο.

Αυτή η δομή διασφαλίζει προβλέψιμη χρέωση και απόδοση.