راهنمای شروع سریع Kimi api

پیش‌نیازها: نصب SDK

کتابخانه رسمی SDK را برای زبان مورد علاقه خود نصب کنید تا احراز هویت و سریال‌سازی را به‌طور خودکار انجام دهد. API ما از استاندارد OpenAI پیروی می‌کند، بنابراین هر کتابخانه کلاینت سازگار با حداقل تغییرات پیکربندی کار می‌کند.

برای Python، کتابخانه را از طریق pip نصب کنید. برای Node.js، از npm یا yarn استفاده کنید. این ابزارها مدیریت کلاینت HTTP و تجزیه JSON را برای شما انجام می‌دهند.

احراز هویت: تنظیم کلید API kimi

کلید خود را از داشبورد دریافت کنید و آن را به عنوان ارسال کنید Authorization header. از URL پایه 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 در بدنه درخواست. این قطعات را به صورت رویدادهای ارسال‌شده توسط سرور (SSE) برمی‌گرداند.

جریان SSE را تجزیه کنید تا توکن‌ها را به‌صورت بلادرنگ نمایش دهید. آخرین قطعه شامل آمار مصرف توکن برای صورت‌حساب است.

پیکربندی فراخوانی تابع

ابزارها را در تعریف کنید tools آرایه در درخواست خود. مدل در صورت لزوم به جای متن مستقیم، فراخوانی‌های ابزار را برمی‌گرداند.

فراخوانی‌های ابزار را در منطق برنامه خود مدیریت کنید و نتایج را برای پردازش بیشتر به API ارسال کنید. پشتیبانی از tool_choice اجرای دقیق را امکان‌پذیر می‌سازد.

مدیریت خطا و محدودیت‌ها

خطاهای استاندارد HTTP را مدیریت کنید: 401 برای کلیدهای نامعتبر، 402 برای اعتبار ناکافی و 429 برای محدودیت نرخ. پنجره متن (context window) در مجموع از 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"}]
  }'

پایتون

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)