Τεκμηρίωση API - KimiCode

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

Συνδέστε τον κώδικά σας στο API μας ενημερώνοντας τη βάση URL και παρέχοντας το κλειδί σας στην κεφαλίδα. Υποστηρίζουμε τυπική αυθεντικοποίηση, οπότε οι υπάρχοντες OpenAI SDK clients λειτουργούν ακαριαία χωρίς πολύπλοκη ρύθμιση. Το API key σας εμφανίζεται ακαριαία μετά την εγγραφή μέσω Google ή email, χωρίς να απαιτείται αριθμός τηλεφώνου.

Κάθε λογαριασμός διαθέτει ένα ενεργό κλειδί τη φορά· η δημιουργία νέου κλειδιού αντικαθιστά το παλιό. Τα αιτήματα επαληθεύονται μέσω του header Authorization, εξασφαλίζοντας ασφαλή πρόσβαση στο προπληρωμένο υπόλοιπό σας.

Πρώτη αίτηση

Στείλτε το πρώτο μήνυμα χρησιμοποιώντας το τυπικό endpoint chat completions με μια απλή POST αίτηση. Αυτό επιβεβαιώνει ότι η ενσωμάτωση σας λειτουργεί πριν προχωρήσετε σε προηγμένα χαρακτηριστικά ή streaming δεδομένων. Η απάντηση επιστρέφει κείμενο από το uncensored μοντέλο.

• Αντικαταστήστε το YOUR_API_KEY με το key σας από το dashboard.
• Ορίστε το μοντέλο σε 'uncensored' για το συγκεκριμένο μοντέλο ανοιχτού βάρους μας.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

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

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για αλληλεπίδραση με το API μας κατευθύνοντάς την στη βάση URL μας. Αυτή η προσέγγιση αξιοποιεί γνωστή σύνταξη, επιτρέποντάς σας να αλλάξετε παρόχους χωρίς να ξαναγράψετε όλη τη λογική της εφαρμογής σας. Το SDK χειρίζεται αυτόματα τον τokenization και τον σχηματισμό αιτημάτων.

• Εγκαταστήστε το πακέτο openai μέσω pip.
• Ρυθμίστε τη βασική διεύθυνση URL ώστε να κατευθύνει στην υπηρεσία μας.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicodepricing.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 SDK Integration

Ενσωματώστε το API μας σε εφαρμογές JavaScript ή TypeScript χρησιμοποιώντας το Node SDK. Αυτό διασφαλίζει συνεπή συμπεριφορά στα περιβάλλοντα frontend και backend. Μπορείτε να περάσετε μηνύματα και να λάβετε απαντήσεις ακριβώς όπως θα κάνατε με οποιοδήποτε τυποποιημένο OpenAI-compatible service.

Copyimport OpenAI from "openai";

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

Ενεργοποιήστε τη ροή για παραγωγή tokens σε πραγματικό χρόνο μέσω Server-Sent Events (SSE). Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες και επιτρέπει την άμεση εμφάνιση μερικών αποτελεσμάτων. Τα δεδομένα χρήσης tokens, συμπεριλαμβανομένων των μετρήσεων εισόδου και εξόδου, ενσωματώνονται στο τελευταίο τμήμα της ροής.

Αυτή η μέθοδος είναι ιδανική για διεπαφές chat όπου η άμεση ανατροφοδότηση έχει σημασία. Μπορείτε να αναλύσετε το stream για να ενημερώσετε το UI προοδευτικά χωρίς να περιμένετε ολόκληρη την απάντηση.

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

Διαχειριστείτε τη χρήση σας κατανοώντας τα όρια ταχύτητας (rate limits) και τους συνηθισμένους κωδικούς σφάλματος. Το API υποστηρίζει παράθυρο context 100,000 tokens, επιτρέποντας βαθιά ιστορία συνομιλίας. Περιορίζεστε σε 300 αιτήσεις ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί.

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

Τα σφάλματα δεν καταναλώνουν το πιστωτικό σας υπόλοιπο, οπότε μπορείτε να επαναλάβετε τις αποτυχημένες αιτήσεις χωρίς ποινή.