دليل البدء السريع لـ Kimi api

المتطلبات الأساسية: تثبيت حزمة التطوير (SDK)

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك المفضلة للتعامل مع المصادقة والتسلسل تلقائيًا. تتبع واجهة برمجة التطبيقات الخاصة بنا معيار OpenAI، لذا فإن أي مكتبة عميل متوافقة تعمل مع تغييرات تكوين دنيا.

بالنسبة لـ Python، قم بتثبيت المكتبة عبر pip. بالنسبة لـ Node.js، استخدم npm أو yarn. تدير هذه الأدوات عميل HTTP وتحليل JSON لك.

المصادقة: ضبط مفتاح kimi API الخاص بك

احصل على مفتاحك من لوحة التحكم ومرره كـ Authorization الرأس. استخدم عنوان URL الأساسي https://api.apikimi.cc/v1 لجميع الطلبات.

احفظ المفتاح بأمان في متغيرات البيئة الخاصة بك أو ملفات التكوين. تنسيق الرأس هو Bearer YOUR_API_KEY.

إرسال طلبك الأول

أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج الخاص بك uncensored. تعيد الاستجابة النص المُولّد مباشرة.

تأكد من تعيين model field بشكل صحيح. تعيد واجهة برمجة التطبيقات الإخراج الخام دون رفض المحتوى للمواضيع القانونية.

استجابات البث

فعّل البث عن طريق تعيين stream: true في جسم الطلب الخاص بك. يُعيد هذا الشرائح كأحداث مُرسلة من الخادم (SSE).

قم بتحليل تدفق SSE لعرض الرموز المميزة في الوقت الفعلي. تتضمن الشريحة الأخيرة إحصائيات استخدام الرموز المميزة للفوترة.

إعداد استدعاء الوظائف

عرّف الأدوات في tools مصفوفة ضمن طلبك. يُرجع النموذج استدعاءات الأدوات بدلاً من النص المباشر عند الاقتضاء.

عالج استدعاءات الأدوات في منطق التطبيق الخاص بك وأرسل النتائج مرة أخرى إلى 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)