Βασικό URL και Αυθεντικοποίηση
Συνδεθείτε στο API χρησιμοποιώντας τη βασική διεύθυνση URL που παρέχεται και ένα κλειδί προπληρωμένου token. Κάνετε έλεγχο ταυτότητας περνώντας το κλειδί API σας στην κεφαλίδα της αίτησης, διασφαλίζοντας ότι μόνο ο λογαριασμός σας έχει πρόσβαση στα πιστωτικά του. Εγγραφείτε μέσω Google ή email για να λάβετε το κλειδί σας άμεσα, χωρίς επαλήθευση τηλεφώνου.
curl https://api.kimicodeapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current rate limit for free tier users?"}]
}'Οι αιτήσεις σας στοχεύουν στο τυπικό endpoint συμβατό με OpenAI. Αυτός ο σχεδιασμός σας επιτρέπει να αντικαταστήσετε την υπηρεσία μας χωρίς να ξαναγράψετε τον υπάρχοντα κώδικα του πελάτη σας, αρκεί να ενημερώσετε τη βάση URL και τα διαπιστευτήρια.
Τερματικό Συμπληρώματος Συζήτησης
Στείλτε μηνύματα στο μοντέλο χρησιμοποιώντας το POST /v1/chat/completions endpoint. Πρέπει να καθορίσετε το ID του μοντέλου ως uncensored για πρόσβαση στο βελτιστοποιημένο μοντέλο γλώσσας μεγάλου μεγέθους που τρέχει στους διακομιστές μας. Το σύστημα δέχεται τυπικούς ρόλους μηνυμάτων όπως user ή assistant για πολυστροφικές συνομιλίες.
from openai import OpenAI
client = OpenAI(base_url="https://api.kimicodeapi.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)Αυτό το endpoint διαχειρίζεται είσοδο κειμένου και επιστρέφει παραγόμενο κείμενο. Δεν υποστηρίζει embeddings, εικόνες ή ήχο. Εστιάστε στη δομή της εντολής (prompt) σας για να λάβετε τα καλύτερα αποτελέσματα από το μοντέλο χωρίς λογοκρισία.
Streaming Αποκρίσεις (SSE)
Ενεργοποιήστε την παράδοση token σε πραγματικό χρόνο ρυθμίζοντας την παράμετρο stream σε true στο αίτημά σας. Το API επιστρέφει chunks Server-Sent Events (SSE), επιτρέποντας στην εφαρμογή σας να εμφανίζει κείμενο καθώς παράγεται. Το τελευταίο chunk περιέχει τα στατιστικά πλήρους χρήσης token για χρέωση.
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)Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για τους τελικούς χρήστες. Μπορείτε να επεξεργαστείτε κάθε token καθώς φτάνει, κάτι που είναι ιδανικό για διεπαφές συνομιλίας. Θυμηθείτε ότι το streaming δεν αλλάζει τη συμπεριφορά του υποκείμενου μοντέλου ή την τιμολόγηση tokens.
Function Calling και Εργαλεία
Ορίστε εργαλεία στο αίτημά σας για να επιτρέψετε στο μοντέλο να επιστρέψει δομημένες κλήσεις συναρτήσεων. Το API υποστηρίζει παραμέτρους tool_choice, επιτρέποντάς σας να εξαναγκάσετε το μοντέλο να χρησιμοποιήσει ένα συγκεκριμένο εργαλείο ή να αποφασίσει αυτόνομα. Αυτή η λειτουργία λειτουργεί με τυπικά σχήματα εργαλείων OpenAI, καθιστώντας την ενσωμάτωση απλή.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimicodeapi.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);Χρησιμοποιήστε κλήση συναρτήσεων για εξαγωγή δεδομένων ή ενεργοποίηση ενεργειών στις εφαρμογές σας. Το μοντέλο ερμηνεύει τους ορισμούς των εργαλείων και επιστρέφει αντικείμενα JSON που περιέχουν τα απαραίτητα ορίσματα. Αυτή η δυνατότητα επεκτείνει το API πέρα από την απλή δημιουργία κειμένου.
Λειτουργία JSON και Παράμετροι
Επιβάλετε αυστηρή έξοδο JSON ρυθμίζοντας response_format για {"type": "json_object"}. Αυτό εξασφαλίζει ότι το μοντέλο επιστρέφει έγκυρο JSON, το οποίο είναι κρίσιμο για την προγραμματιστική ανάλυση. Μπορείτε επίσης να προσαρμόσετε παραμέτρους όπως η θερμοκρασία, το top_p και οι ακολουθίες διακοπής για να ελέγξετε τη δημιουργικότητα και το μήκος της εξόδου.
Το μοντέλο υποστηρίζει παράθυρο πλαισίου 100.000 tokens. Αυτό σας επιτρέπει να περάσετε μεγάλες ποσότητες πλαισίου σε ένα μόνο αίτημα. Η μέγιστη έξοδος είναι 16.000 tokens ανά αίτημα, ή 2.048 αν δεν καθορίσετε max_tokens.
Όρια, Σφάλματα και Context
Παρακολουθήστε τα όρια των αιτημάτων σας για να αποφύγετε διακοπές στην παροχή υπηρεσιών. Το API επιτρέπει 300 αιτήματα ανά λεπτό ανά κλειδί και έως 8 ταυτόχρονα. Το σώμα του αιτήματός σας πρέπει να παραμένει κάτω από 8 MB. Αν υπερβείτε αυτά τα όρια, λαμβάνετε σφάλμα ορίου ρυθμού 429.
Οι αποτυχίες πιστοποίησης επιστρέφουν σφάλμα 401 αν το key είναι άκυρο. Ένα σφάλμα 402 υποδεικνύει ανεπαρκά prepaid credit. Τα σφάλματα κατά τη δημιουργία δεν καταναλώνουν τα tokens σας. Το context window περιλαμβάνει τόσο tokens prompt όσο και completion. Το unused credit δεν λήγει ποτέ, διασφαλίζοντας ότι το prepaid balance σας παραμένει διαθέσιμο για μελλοντικά projects.
