Τεκμηρίωση API: OpenAI-Compatible Endpoints

Πιστοποίηση & Base URL

Πρόσβαση στο API ρυθμίζοντας το μοναδικό σας key και το base URL στις μεταβλητές περιβάλλοντος. Το endpoint βρίσκεται στο https://api.apikeykimi.com/v1.Πρέπει να συμπεριλάβετε το header Authorization: Bearer YOUR_API_KEY με κάθε request. Αυτό το key δημιουργείται άμεσα κατά την εγγραφή μέσω Google ή email. Είναι το μόνο διαπιστευτήριο που απαιτείται για την πιστοποίηση. Δεν χρειάζεται διαμόρφωση scopes ή δικαιωμάτων.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

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

Στείλτε μηνύματα στο μοντέλο χρησιμοποιώντας το τυπικό /v1/chat/completions endpoint. Ορίστε το model ID ως uncensored στο request body. Το API επιστρέφει παραγόμενο κείμενο βάσει της ιστορικού prompts σας. Μπορείτε να προσαρμόσετε παραμέτρους όπως temperature και top_p για να ελέγξετε τη δημιουργικότητα. Το μοντέλο υποστηρίζει function calling και JSON mode για structured outputs.

Copyfrom openai import OpenAI

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

Ενεργοποίηση παράδοσης token σε πραγματικό χρόνο ορίζοντας stream: true στην αίτησή σας. Ο διακομιστής επιστρέφει μια ροή Server-Sent Events. Κάθε τμήμα περιέχει μερικό κείμενο μέχρι να ολοκληρωθεί η απάντηση. Αυτό είναι ιδανικό για διεπαφές συνομιλίας και ζωντανές εμφανίσεις κώδικα. Οι λεπτομέρειες χρήσης 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)

Συνάρτηση Calling & JSON Mode

Ορίστε εργαλεία ή επιβάλετε έξοδο JSON χρησιμοποιώντας το response_format parameter. Ορίστε json_object για να διασφαλιστούν έγκυρες απαντήσεις JSON. Μπορείτε επίσης να περάσετε ορισμούς εργαλείων για κλήση συναρτήσεων. Το μοντέλο συμμορφώνεται αυστηρά σε αυτούς τους περιορισμούς. Αυτό επιτρέπει αξιόπιστη ενσωμάτωση με εξωτερικές υπηρεσίες. Χρησιμοποιήστε tool_choice για τον έλεγχο του πώς καλούνται τα εργαλεία.

Όρια & Περιορισμοί Token

Το παράθυρο πλαισίου (context window) υποστηρίζει έως 100.000 tokens για την είσοδο και την έξοδο συνολικά. Η μέγιστη έξοδος ανά αίτημα είναι 16.000 tokens. Αν δεν ορίσετε max_tokens, το όριο προεπιλογής είναι 2.048 tokens. Οι αιτήσεις περιορίζονται σε 8 MB στο μέγεθος του σώματος. Περιορίζεστε σε 300 αιτήσεις ανά λεπτό. Μόνο 8 αιτήσεις μπορούν να τρέχουν ταυτόχρονα ανά key.

Χειρισμός Σφαλμάτων & Όρια Χρήσης

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

Node.js

Copyimport OpenAI from "openai";

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