kimiapikey.comالدليل
دمج مفتاح Kimi API مع مكتبات OpenAI SDK وLangChain
يتطلب دمج هذه API في التطبيق تغيير قيمتين في الكود الذي تملكه غالباً: عنوان URL الأساسي والمفتاح. يوضح هذا الدليل التغيير لمكتبات OpenAI SDK وLangChain وLiteLLM، ثم يغطي آليات إعادة المحاولة والحدود للاستخدام الإنتاجي.
تم التحديث

نقاط رئيسية
- يحتاج كل عميل إلى نفس القيم الثلاث: عنوان URL الأساسي https://api.kimiapikey.com/v1, مفتاحك والنموذج
uncensored. - احفظها في متغيرات البيئة لتتمكن من تغيير المزودين دون تعديل الكود.
- عالج استجابات 429 بشكل منفصل: rate_limited، concurrency، وحملاً زائداً مؤقتاً مع Retry-After: 5.
- يتيح المفتاح الكامل 8 طلبات متزامنة و300 في الدقيقة؛ ويتيح المفتاح التجريبي 2 و60.
ما الذي يتغير فعلياً في كودك
يبدو أن دمج مفتاح API الخاص بـ kimi مشروعاً، لكنه بالنسبة إلى نقطة النهاية هذه مجرد تغيير في الإعداد. تنفّذ الخدمة تنسيق إكمال الدردشة الخاص بـ OpenAI، لذا فإن أي مكتبة عميل تتيح لك تعيين عنوان URL الأساسي ومفتاحاً ستعمل. لا يوجد SDK مخصص للتثبيت ولا يحتاج الأمر إلى تعلم شكل طلب جديد.
| الإعداد | القيمة |
|---|---|
| عنوان URL الأساسي | https://api.kimiapikey.com/v1 |
| مفتاح API | المفتاح من لوحة التحكم، يُرسل كـ Authorization: Bearer |
| النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions، GET /v1/models |
نقطتان توفران الوقت. أولاً، هذا نموذج نصي خلف نقطة نهاية واحدة: لا يوجد مسار للتضمين، ولا توليد صور، ولا صوت. إذا كان تطبيقك يستدعي هذه الميزات، فاستخدم مزوداً آخر لها ووجّه الدردشة فقط إلى هنا. ثانياً، هذه ليست الـ API الرسمية لـ Kimi أو أي بائع آخر؛ إنها مزود مستقل يشغّل نموذجاً واحداً مفتوح الأوزان، لذا لن تُحل أسماء النماذج من المنصات الأخرى. يغطي شرح مفتاح Kimi API هذا الفرق بتفصيل أكثر.
احصل على مفتاحك من صفحة مفتاح API. يمكن للحسابات الجديدة المطالبة بـ $0.50 من رصيد تجريبي هناك، وهو كافٍ لكل ما يلي.
الإعدادات ونقل تطبيق موجود
تقرأ المكتبات الرسمية لـ Python وNode.js الخاصة بـ OpenAI المتغير OPENAI_API_KEY والمتغير OPENAI_BASE_URL من البيئة عند عدم تمريرها صراحةً. وهذا يجعل دمج الحد الأدنى جهداً تغييراً في الـ shell:
export OPENAI_BASE_URL="https://api.kimiapikey.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
الكود الموجود الذي يبني عميل OpenAI() عاري يتصل الآن بنقطة النهاية هذه. لا يزال عليك تغيير معامل model إلى uncensored. ضع اسم النموذج في متغير أيضاً، على سبيل المثال LLM_MODEL، بحيث يمكن أن يختلف بيئة الاختبار عن بيئة الإنتاج دون تعديل في الكود.
هذه العادة تستحق الدقيقة التي تأخذها. عندما يعيش عنوان URL الأساسي والمفتاح والنموذج في ملف الإعدادات، فإن تجربة مزود متوافق مع OpenAI هي تغيير في النشر، وإرجاع التغيير هو نفس التغيير بالعكس.
معظم الفرق لا تبدأ من ملف فارغ. لديهم تطبيق يستدعي بالفعل واجهة برمجية على طراز OpenAI، ويريدون أن يستدعي هذا المزود. عملية الترحيل هي في الغالب بحث عن ثلاث سلاسل نصية.
- اعثر على مكان بناء العميل وقم بتغيير عنوان URL الأساسي.
- اعثر على كل معامل
model=واستبدل الاسم القديم بـuncensored. - ابحث عن الميزات التي يستخدمها الكود ولا توفرها هذه الـ API، مثل التضمين، أو توليد الصور، أو الصوت. يجب أن تبقى هذه المكالمات مع مزود آخر أو تُحذف.
ثم قارن السلوك، وليس فقط البنية. نموذج مختلف له صوت مختلف، وطول افتراضي مختلف وعادات مختلفة في التنسيق. شغّل موجّهات الاختبار الموجودة لديك، اقرأ الإجابات جنباً إلى جنب وعدّل الموجّه النظامي حيث انحرفت النبرة. النصوص التي عملت حول عيوب نموذج آخر قد لا تفعل شيئاً هنا، وأحياناً تجعل الأمور أسوأ، لذا أزل الحلول المؤقتة القديمة واحدة تلو الأخرى وراقب ما يتغير.
تحقق أيضاً من المعاملات التي تمررها. تُمرَّر temperature وtop_p وstop وseed وعقوبات التكرار كما هي، لذا تتصرف كما تتوقع. الحقول الخاصة بمزودين آخرين أو بالميزات التي تفتقر إليها هذه الـ API لن تفعل أي شيء مفيد. اجعل جسم الطلب صغيراً وموحداً. حد جسم الطلب هو 8 MB، وهو مهم فقط إذا كنت تضمّن مستندات كبيرة مباشرة.
Python: متزامن، بث متدفق وغير متزامن
الشكل الصريح، الذي لا يعتمد على متغيرات البيئة:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You answer in plain English."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage.prompt_tokens, resp.usage.completion_tokens)
للبث المتدفق، اضبط stream=True واقرأ القطع مع وصولها. يتم تسليم البث عبر أحداث الخادم المرسلة (SSE)، ويُبلغ عن الاستخدام في النهاية.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a limerick about retries."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
بالنسبة لخدمة تتعامل مع العديد من المستخدمين، استخدم العميل غير المتزامن وحدد التوازي الخاص بك بحيث لا تتجاوز أبداً حد التوازي الخاص بالمفتاح. يعد السيمافور (semaphore) أبسط طريقة:
import asyncio
from openai import AsyncOpenAI
client = AsyncOpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
gate = asyncio.Semaphore(8)
async def ask(prompt: str) -> str:
async with gate:
r = await client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
async def main():
prompts = [f"Give one fact about the number {n}." for n in range(20)]
answers = await asyncio.gather(*(ask(p) for p in prompts))
print(len(answers), "answers")
asyncio.run(main())
اضبط السيمافور على 2 أثناء استخدامك للمفتاح التجريبي، وعلى 8 للمفتاح الممول.
Node وTypeScript
تأخذ مكتبة Node الخيارين نفسيهما تحت أسماء مختلفة قليلاً:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const completion = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three HTTP status codes." }],
});
console.log(completion.choices[0].message.content);
يستخدم البث المتدفق مع نفس العميل stream: true ومكرر غير متزامن (async iterator) عبر النتيجة. إذا كنت تستخدم إطار عمل للواجهة الأمامية يلتف حول مكتبة OpenAI، مثل مجموعة أدوات واجهة محادثة، ابحث عن خيار عنوان URL الأساسي الخاص به واضبطه بنفس الطريقة. احتفظ بالمفتاح على الخادم. المفتاح الموضوع في كود المتصفح يمكن نسخه من قبل أي شخص يفتح أدوات المطور، والرصيد خلفه هو أموال حقيقية.
LangChain و LiteLLM
الأطر التي تغلف عميل OpenAI تعرض عادة نفس المعاملين. في LangChain لـ Python، تقبل فئة نموذج المحادثات الخاص بـ OpenAI هذه المعاملات مباشرة:
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="uncensored",
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
temperature=0.5,
)
reply = llm.invoke("Summarize what a message queue does in one sentence.")
print(reply.content)
من هناك، تعمل السلاسل وقوالب الموجّه ومحللات المخرجات كما تعمل مع أي نموذج دردشة. إذا قمت بربط الأدوات، يدعم الـ API استدعاء الدوال عبر tools و tool_choice، وتعود نتائج الأدوات إلى النموذج كرسائل role: "tool"، وهو ما ينتجه إطار العمل.
يُعد LiteLLM مفيداً عندما تريد اتفاقية استدعاء موحدة عبر عدة مزودين. أضف بادئة openai/ إلى اسم النموذج، ومرّر عنوان URL الأساسي كـ api_base:
import litellm
resp = litellm.completion(
model="openai/uncensored",
api_base="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
messages=[{"role": "user", "content": "Say hello in French."}],
)
print(resp.choices[0].message.content)
للبيانات المهيكلة، مرر response_format={"type": "json_object"} واذكر في الموجّه أنك تريد JSON. قم دائماً بتحليل النتيجة بشكل دفاعي، لأن وضع JSON يطلب JSON صالحاً لكن مخططك لا يزال مجرد طلب في الموجّه.
الحدود، إعادة المحاولة، ومعالجة الأخطاء
المفتاح الممول يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. المفتاح التجريبي يسمح بـ 2 و60. يمكن أن يصل حجم الجسم إلى 8 ميجابايت، والنافذة هي 100,000 رمز للموجه والمكمل معاً. عند تجاوز حد، يجيب الـ API بـ HTTP 429 وواحد مما يلي:
rate_limited: عدد كبير جداً من الطلبات في الدقيقة. انتظر بضع ثوانٍ.concurrency: عدد كبير جداً من الطلبات تعمل في وقت واحد. انتظر حتى ينتهي أحدها. يحمل الطلب المتدفق مكانه حتى ينتهي البث، لذا فإن المستهلك البطيء يُحسب ضدك.- 429 مع
Retry-After: 5: حمل زائد مؤقت. انتظر خمس ثوانٍ وحاول مرة أخرى.
غلاف إعادة محاولة صغير يحترم الرأس يتعامل مع الحالات الثلاث:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.kimiapikey.com/v1", api_key="YOUR_KEY", max_retries=0)
def chat(messages, tries=4):
for attempt in range(tries):
try:
return client.chat.completions.create(model="uncensored", messages=messages)
except RateLimitError as e:
wait = int(e.response.headers.get("retry-after", 2 ** attempt))
time.sleep(wait)
raise RuntimeError("still rate limited after retries")
لا تُحسب الطلبات الفاشلة أو المرفوضة، لذا فإن إعادة المحاولة لا تحمل عقوبة فواتير. سجّل رأس الاستجابة X-Request-Id مع كل استدعاء؛ فهو أسرع طريقة للإشارة إلى طلب واحد إذا بدا شيء ما خاطئاً. يخبرك X-Balance-USD بمقدار الرصيد المتبقي، والذي يمكنك تغذيته إلى تنبيه. تذكر أن الوثائق تسرد جميع رؤوس الاستجابة.
استدعاء الأدوات عبر إطار عمل
تعتمد أطر عمل الوكلاء على استدعاء الأدوات، لذا تستحق اختباراً قصيراً قبل البناء عليها. يقبل هذا الـ API tools و tool_choice، ويعيد tool_calls عندما يريد النموذج تشغيل دالة، ويتوقع النتيجة كرسالة role: "tool" تشير إلى معرف المكالمة. يعمل البث المتدفق مع الأدوات، حيث تصل المكالمة في أجزاء يجمعها لك الـ SDK.
أول اختبار جيد هو وكيل بأداة واحدة لديه دالة يمكنك التحقق من نتائجها بالعين، مثل آلة حاسبة أو بحث في قاموس صغير. شغّله عشر مرات. إذا اختار النموذج الأداة وملأ حججها بشكل صحيح في كل مرة، يمكنك إضافة أداة ثانية. إذا كان أحياناً يجيب من الذاكرة بدلاً من استدعاء الدالة، اجعل وصف الأداة أكثر تحديداً، أو اضبط tool_choice لفرض الاستدعاء لتلك الخطوة. تختلف النماذج في مدى موثوقيتها في قيادة سلاسل طويلة من الاستدعاءات، لذا اجعل السلاسل قصيرة وأضف حداً للخطوات في أي حلقة حتى لا تدور الحلقة المربكة إلى الأبد وتستهلك الرصيد.
قائمة مراجعة قصيرة قبل الإطلاق
- قم بتشغيل طلب واحد عبر curl أو الـ SDK وتأكد من وجود كتلة الاستخدام.
- اختبر البث المتدفق مع العميل الذي سيتم استخدامه في الإنتاج، بما في ذلك ما يحدث عندما يغلق المستخدم الصفحة أثناء البث.
- حدد أقصى حد للتزامن الخاص بك دون حد المفتاح.
- اضبط
max_tokensحيث تتوقع إجابات قصيرة، وقص سجل الدردشة قبل أن ينمو بما يتجاوز ما تريد الدفع مقابله. - احتفظ بالمفتاح في تكوين الخادم وقم بتدويره إذا ظهر في سجل.
- تحقق من التكلفة على حركة المرور الحقيقية. بسعر $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، يكلف الطلب الذي يحتوي على 3,000 رمز مدخل و700 مخرج $0.0008، لذا فإن 10,000 منها تكلف حوالي $8. التفاصيل موجودة في صفحة الأسعار.
الموجّهات المرسلة إلى الـ API لا تُستخدم للتدريب. قاعدة المحتوى الوحيدة التي لا تتغير أبداً هي الحد الصارم على المحتوى الجنسي الذي ينطوي على القاصرين؛ النموذج مضبوط بشكل عام للإجابة بدون رفض للاستخدام القانوني للبالغين، لذا يجب على التطبيقات التي تخدم الجمهور إضافة الإشراف الخاص بها على المحتوى وفحوصات العمر حيث يتوقع القانون أو مستخدموك ذلك.
المزيد من الأدلة
- استخدم مفتاح API بأسلوب Kimi في Cursor: دليل الإعداد
- أسعار مفتاح Kimi API: كم يكلف هذا البديل
- مفتاح Kimi API: كيف يعمل وما هي البدائل
الأسئلة الشائعة
هل النموذج هو نفسه Kimi الرسمي الخاص بـ Moonshot؟
لا، نحن نستضيف نموذجاً مفتوح الأوزان الذي تم ضبطه ليكون بدون رقابة. إنه ليس GPT، أو Claude، أو Gemini، أو Grok، أو DeepSeek، أو أي نموذج آخر من البائعين. إنه نموذج مميز يعمل على خوادمنا الخاصة.
هل تدربون على بياناتي؟
لا. لا تُستخدم الموجّهات والإكمال الخاصين بك في التدريب. نقدّر الخصوصية والشفافية، لذا تبقى بياناتك ملكاً لك.
ما هي حدود المعدل؟
محدود بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 MB. صُممت هذه الحدود لضمان أداء مستقر لجميع المستخدمين.
ما هي سياسة المحتوى؟
النموذج بدون رقابة فيما يتعلق بالمواضيع البالغة والجدلية والإبداعية. ومع ذلك، نحجب المحتوى الجنسي الذي يتضمن قاصرين. هذا حدّ صارم ينطبق دائماً، بغض النظر عن مستوى اشتراكك.
أسئلة وأجوبة
هل أحتاج إلى SDK خاص؟
لا. تعمل مكتبات OpenAI القياسية لـ Python وNode بعد أن تضبط عنوان URL الأساسي إلى https://api.kimiapikey.com/v1 وتستخدم مفتاحك. تعمل LangChain وLiteLLM بنفس الطريقة.
ما هو اسم النموذج الذي يجب أن يستخدمه كودي؟
استخدم uncensored. إنه معرف النموذج الوحيد الذي يخدمه الـ API، وGET /v1/models يسرده.
كيف أتجنب أخطاء 429؟
حدّ الطلبات المتزامنة الخاصة بك إلى 8 على مفتاح ممول، أو 2 على مفتاح تجريبي، وأعد المحاولة بعد مهلة Retry-After عندما تطلب الـ API ذلك.
هل يدعم استدعاء الدوال ووضع JSON؟
نعم. استخدم tools وtool_choice لاستدعاء الدوال، و response_format مع type json_object للإخراج بصيغة JSON. كما يعمل البث المتدفق.
هل يمكنني استخدام التضمينات أو توليد الصور عبر نفس المفتاح؟
لا. الـ API مخصص للدردشة النصية فقط، ولا يدعم نقاط النهاية الخاصة بالتضمينات أو الصور أو الصوت أو الفيديو.
مفتاحك على بُعد نموذج تسجيل واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذا هو الإعداد بأكمله.