מדריך התחלה מהירה ל-API של Kimi

דרישות מוקדמות: התקנת SDK

התקן את ה-SDK הרשמי לשפת התכנות המועדפת עליך כדי לטפל באימות וברצף בקשות באופן אוטומטי. ה-API שלנו עומד בתקן OpenAI, כך שכל ספריית לקוח תואמת תעבוד עם שינויי תצורה מינימליים.

ל-Python, התקן את הספרייה דרך pip. ל-Node.js, השתמש ב-npm או yarn. כלים אלו מנהלים עבורך את לקוח ה-HTTP ואת פיענוח ה-JSON.

אימות: הגדרת מפתח ה-kimi שלך

Obtain your key from the dashboard and pass it as the Authorization header. השתמש בכתובת הבסיס https://api.apikimi.cc/v1 לכל הבקשות.

אחסן את המפתח בצורה מאובטחת במשתני הסביבה או בקבצי התצורה. פורמט הכותרת הוא Bearer YOUR_API_KEY.

שליחת הבקשה הראשונה שלך

שלחו בקשת POST ל /v1/chat/completions עם מזהה הדגם שלך uncensored. התגובה מחזירה את הטקסט שנוצר ישירות.

ודא שאתה מגדיר את model field correctly. The API returns raw output without content refusals for lawful topics.

תגובות בסטרימינג

אפשרו זרימה על ידי הגדרת stream: true בגוף הבקשה שלך. זה מחזיר נתחים כ-Aירועים שנשלחים מהשרת (SSE).

נתח את זרם ה-SSE כדי להציג מילים בזמן אמת. הנתח הסופי כולל סטטיסטיקות שימוש במילים לחישוב חשבונות.

הגדרת פקודות פונקציה

הגדירו כלים ב- tools מערך בתוך הבקשה שלך. המודל מחזיר קריאות כלי במקום טקסט ישיר כאשר מתאים.

טפל בפקודות הכלים (tool calls) בלוגיקה של האפליקציה שלך ושלח את התוצאות חזרה ל-API לעיבוד נוסף. תמיכה ב tool_choice מאפשרת אכיפה קפדנית.

טיפול בשגיאות ומגבלות

טפלו בשגיאות HTTP סטנדרטיות: 401 למפתחות לא חוקיים, 402 לחוסר באשראי, ו-429 לגבולות קצב הבקשות. חלון ההקשר תומך בסך הכל ב-100,000 טוקנים.

פלט מקסימלי הוא 16,000 טוקנים לכל בקשה. שגיאות לא צורכות אשראי. התאם את לוגיקת הניסיון החוזר שלך בהתאם לקוד השגיאה.

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)