Οδηγός Γρήγορης Έναρξης API Kimi

Προαπαιτούμενα: Εγκατάσταση SDK

Εγκαταστήστε το επίσημο SDK για τη γλώσσα σας ώστε να διαχειρίζεται αυτόματα την πιστοποίηση και τη σειριοποίηση. Η API μας ακολουθεί το πρότυπο OpenAI, οπότε οποιαδήποτε συμβατή βιβλιοθήκη πελάτη λειτουργεί με ελάχιστες αλλαγές διαμόρφωσης.

Για Python, εγκαταστήστε τη βιβλιοθήκη μέσω pip. Για Node.js, χρησιμοποιήστε το npm ή yarn. Αυτά τα εργαλεία διαχειρίζονται τον HTTP client και την ανάλυση JSON για εσάς.

Πιστοποίηση: Ρύθμιση του API key kimi

Obtain your key from the dashboard and pass it as the Authorization header. Χρησιμοποιήστε το base URL https://api.apikimi.cc/v1 για όλες τις αιτήσεις.

Αποθηκεύστε το κλειδί με ασφάλεια στις μεταβλητές περιβάλλοντός σας ή στα αρχεία διαμόρφωσης. Η μορφή header είναι Bearer YOUR_API_KEY.

Αποστολή της πρώτης σας αίτησης

Στείλτε ένα POST request στο /v1/chat/completions με το μοντέλο ID σας uncensored. Η απάντηση επιστρέφει το παραγόμενο κείμενο απευθείας.

Βεβαιωθείτε ότι ορίζετε το model field σωστά. Το API επιστρέφει ωμή έξοδο χωρίς απορρίψεις περιεχομένου για νόμιμα θέματα.

Streaming Αποκρίσεις

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στο σώμα του αιτήματός σας. Αυτό επιστρέφει κομμάτια ως Server-Sent Events (SSE).

Επεξεργαστείτε τη ροή SSE για να εμφανίσετε tokens σε πραγματικό χρόνο. Το τελικό κομμάτι περιλαμβάνει τα στατιστικά χρήσης tokens για χρέωση.

Ρύθμιση Function Calling

Ορίστε εργαλεία στο tools array εντός του αιτήματός σας. Το μοντέλο επιστρέφει κλήσεις εργαλείων αντί για άμεσο κείμενο όταν είναι κατάλληλο.

Διαχειριστείτε τις κλήσεις εργαλείων στη λογική της εφαρμογής σας και στείλτε τα αποτελέσματα πίσω στο API για περαιτέρω επεξεργασία. Υποστήριξη για tool_choice allows strict enforcement.

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

Διαχειριστείτε τα τυπικά σφάλματα HTTP: 401 για άκυρα κλειδιά, 402 για ανεπαρκές υπόλοιπο και 429 για όρια ρυθμού. Το παράθυρο συμφραζομένων υποστηρίζει συνολικά 100,000 tokens.

Η μέγιστη έξοδος είναι 16,000 tokens ανά αίτημα. Τα σφάλματα δεν καταναλώνουν πιστωτικό. Προσαρμόστε τη λογική επανάληψής σας βάσει του κώδικα σφάλματος.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Ροή

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)