kimiapikey.comالدليل
مفتاح Kimi API لا يعمل: الأسباب والحلول والنقطة الاحتياطية
إذا ظهر خطأ «مفتاح kimi api لا يعمل» كـ 401، 404 أو 429، فإن السبب غالباً يكون أحد خمسة أشياء: Base URL خاطئ، مفتاح غير متطابق، عدم وجود رصيد، حدّ المعدل، أو اسم نموذج لا تعرفه نقطة النهاية. اعمل عليها بهذا الترتيب.
تم التحديث


نقاط رئيسية
- المفتاح يعمل فقط مع المزود الذي أصدره، لذا يجب أن يأتي عنوان URL الأساسي والمفتاح من نفس لوحة التحكم.
- يعني 401 رفض المفتاح، ويعني 404 عادة مساراً خاطئاً، ويعني 429 أنك وصلت إلى حد أو الخدمة مشغولة.
- اطبع رمز الحالة وجسم الاستجابة قبل تغيير أي شيء آخر.
- احتفظ بنقطة نهاية متوافقة مع OpenAI ثانيةً مُهيّأة حتى لا يوقف عطل واحد تطبيقك.
اقرأ رمز الحالة أولاً
قبل إعادة إنشاء أي شيء، انظر إلى ما قاله الخادم فعلياً. تخفي معظم عملاء نمط OpenAI جسم الاستجابة وراء استثناء عام. اطبع كل من الحالة والنص.
curl -i https://api.kimiapikey.com/v1/models \
-H "Authorization: Bearer $YOUR_KEY"
يخبرك السطر الأول من الرد أين تبحث:
| الحالة | المعنى المعتاد | ابدأ بـ |
|---|---|---|
| 401 | تم رفض المفتاح | نسخة المفتاح والمفتاح وعنوان URL الأساسي من مزودين مختلفين |
| 404 | المسار أو النموذج غير موجود | غياب /v1، مسار مكرر، معرف نموذج خاطئ |
| 400 | جسم الطلب غير صالح | أسماء المعاملات، تنسيق الرسالة، حجم الجسم |
| 429 | تم الوصول إلى الحد أو الخدمة مشغولة | معدل الطلب، المكالمات المتزامنة، توقيت إعادة المحاولة |
| 5xx | مشكلة من جانب الخادم | أعد المحاولة مع زيادة زمنية، ثم انتقل إلى نقطة نهاية احتياطية |
إذا لم تحصل على أي استجابة HTTP على الإطلاق (مهلة أو خطأ DNS)، فإن المشكلة هي الشبكة أو اسم المضيف الذي أدخلته، وليس المفتاح.
يجب أن ينتمي Base URL والمفتاح معًا
هذا هو السبب الأكثر شيوعًا لفشل مفتاح جديد. تُصدر المفاتيح لكل مزود. مفتاح من لوحة تحكم واحدة غير معروف ببساطة لخوادم مزود آخر، لذا فإنه يعيد 401 حتى لو كان المفتاح صالحًا تمامًا في المكان الذي جاء منه.
تحقق من هذه النقاط:
- يأتي المفتاح و Base URL من نفس صفحة الحساب. إذا قمت بنسخ المفتاح من مزود واحد وتركت Base URL قديمًا في تكوينك، فإن الطلب يذهب إلى المكان الخطأ.
- متغيرات البيئة لا تُخفي الكود الخاص بك. يقرأ مكتبة OpenAI
OPENAI_API_KEYوOPENAI_BASE_URLعندما لا تمررها صراحةً، لذا يمكن لمتغير قديم في الـ shell أن يتجاوز ما كتبته في الملف. - لا يوجد فراغ أو سطر جديد في نهاية المفتاح. سطر جديد متبقي من النسخ واللصق هو سبب كلاسيكي لـ 401.
- الرأس هو بالضبط
Authorization: Bearer <key>. تتوقع بعض الأدوات المفتاح في رأس مختلف وتحتاج إلى تفعيل وضع OpenAI-compatible.
تضيف محررات النصوص وواجهات الدردشة فخاً آخر. تحتفظ العديد منها بحقل منفصل لـ "عنوان URL الأساسي لـ OpenAI" وزر تبديل منفصل لتفعيله. إذا كان زر التبديل مغلقاً، يستمر التطبيق بصمت في استدعاء المضيف الافتراضي بمفتاحك الجديد، مما يمنحك خطأ 401 يبدو وكأنه مفتاح غير صالح. احفظ الإعدادات، وأعد تشغيل التطبيق إذا كان يخزنها مؤقتاً، وأرسل رسالة اختبار قصيرة واحدة قبل اختبار أي شيء معقد.
يجب أن ينتهي Base URL عند /v1، وليس عند المضيف وليس عند /v1/chat/completions. يضيف SDK الباقي. URL الذي يتضمن بالفعل المسار الكامل ينتهي به الأمر إلى مسار مكرر و 404.
الوصول الإقليمي، وكلاء الشبكات والشبكات المؤسسية
أحيانًا يكون المفتاح على ما يرام ولا يصل الطلب إلى الخادم الصحيح. يمكن أن تعتمد توافر المزود على المكان الذي تتصل منه، وقد يحجب VPN أو وكيل مؤسسي أو قاعدة جدار الحماية حركة المرور أو يعيد كتابتها. انظر إلى وثائق المزود الخاصة أو صفحة الحالة الخاصة بهم للمناطق المدعومة، ولا تفترض أن القواعد هي نفسها لخدمة أخرى.
اختبار عزل سريع: نفّذ أمر curl نفسه من شبكة مختلفة، مثل نقطة اتصال الهاتف. إذا نجح الأمر هناك، فالمفتاح صالح والشبكة هي السبب. إذا كان الوكيل يحدّد HTTPS_PROXY، فتأكد من أن مكتبة HTTP الخاصة بك تحترم هذا الإعداد بالفعل؛ فبعض الأدوات تتجاهله وتفشل بخطأ في الاتصال.
الرصيد، الحصة، وشكل حدّ المعدل
قد يكون المفتاح صالحاً ويرفض الطلبات رغم ذلك، بسبب نفاد رصيد الحساب أو استنفاد الحصة. تحقق من لوحة التحكم قبل تصحيح الكود. إذا لم تقم بشحن الرصيد من قبل، فتذكر أن المخصصات المجانية عادة ما تكون صغيرة وقصيرة الأمد.
الرقم 429 قصة أخرى. يعني أن الخادم يبطئك، لا أن المفتاح سيء. على نقطة النهاية الموصوفة هنا، يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة، والمفتاح التجريبي يسمح بـ 2 متزامن و60 في الدقيقة. عند تجاوزها، تُعيد الـ API رمز الخطأ rate_limited (كثير في الدقيقة) أو concurrency (كثير في آن). التحميل المؤقت يُعيد 429 أيضاً مع رأس Retry-After: 5.
عادتان تحلان معظم هذه المشاكل. التزم بـ Retry-After عند وجوده، وحدد عدد العاملين المتزامنين عند حدّ التزامن. الطلب المتدفق يحتفظ بمكانه حتى ينتهي البث المتدفق، لذا فإن البث المتوقف يحسب ضدك لفترة أطول مما تتوقع.
اسم النموذج، المعاملات، وحجم الجسم
عادةً ما يشير الخطأ 404 أو 400 مع مفتاح صالح إلى الطلب نفسه. هناك ثلاث نقاط يجب التحقق منها:
- معرف النموذج. لكل مزوّد أسماء نماذج خاصة به. اسأل نقطة النهاية عن النماذج التي تقدمها عبر
GET /v1/modelsوانسخ المعرف من الرد. في هذا الموقع، المعرف هوuncensored. - المعاملات. أسماء مثل
max_tokens،temperatureوresponse_formatهي معايير، لكن قد يقبل المزوّد مجموعة فرعية فقط. أزل الحقول الاختيارية حتى يمر الطلب، ثم أضفها مرة تلو الأخرى. - الحجم. قد تفشل الموجّهات الكبيرة جداً بسبب حدود الجسم قبل أن يراها النموذج. هنا الحد الأقصى لحجم الجسم هو 8 MB، ونافذة السياق هي 100,000 رمز لكل من الموجّه والإكمال معاً.
يُعد البث المتدفق مجالاً آخر قد يبدو فيه المفتاح السليم معطلاً. إذا نجح الطلب بدون stream: true وفشل عند تفعيله، فإن السبب غالباً هو وسيط يقوم بتخزين أو قطع أحداث SSE المرسلة من الخادم، وليس نقطة النهاية. أوقف البث المتدفق للتأكد، ثم راجع إعدادات الوسيط.
إذا قمت بتغيير اسم النموذج فقط وتعطل الاتصال، أعد الاسم القديم لتأكيد أن باقي إعداداتك سليم.
احتفظ بنقطة نهاية احتياطية جاهزة
حتى المزوّد السليم لديه أوقات سيئة. إذا كان منتجك يعتمد على مفتاح واحد، فإن فشلًا واحداً يصبح انقطاعاً لك. نظراً لأن تنسيق طلبات OpenAI مشترك، يمكنك إعداد نقطة نهاية ثانية والتبديل إليها بضع سطور فقط.
نقطة النهاية في هذا الموقع متوافقة مع OpenAI، لذا يمكن دمجها كمزوّد ثانٍ. إنها نموذج مفتوح الأوزان مستضاف بشكل مستقل، وليست الخدمة الرسمية لـ Moonshot، وستجيب بشكل مختلف عن نموذج Kimi، لذا اختبر الموجّهات الخاصة بك قبل الاعتماد عليها. إليك غلاف بسيط يجرّب المزوّد الأساسي أولاً ثم يعود إلى البديل عند الأخطاء:
import os
from openai import OpenAI
primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
api_key=os.environ["FALLBACK_KEY"])
def ask(messages):
try:
r = primary.chat.completions.create(
model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
except Exception as e:
print("primary failed:", e)
r = fallback.chat.completions.create(
model="uncensored", messages=messages, timeout=60)
return r.choices[0].message.content
print(ask([{"role": "user", "content": "Say hi in five words."}]))
التسعير يعتمد على الاستخدام: $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز ناتج من رصيد مسبق الدفع الذي لا ينتهي. الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا فإن استراتيجية بديل التي نادراً ما تعمل تكلف تقريباً لا شيء للحفاظ عليها. تبدأ الشحنات من $20؛ انظر التسعير للحصول على مستويات المكافآت.
اختبر نقطة النهاية الاحتياطية في دقيقتين
يمكن للمستخدمين الجدد المطالبة بـ $0.50 من رصيد تجريبي بنقرة واحدة على صفحة مفتاح API بعد تسجيل الدخول. لا يحتاج إلى بطاقة وهو صالح لمدة 7 أيام، وهو ما يكفي لتشغيل الموجّهات الحقيقية الخاصة بك عبر نقطة النهاية مرة واحدة. ثم قم بتشغيل اختبار الدخان أدناه.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $FALLBACK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
تحقق من رأس الاستجابة X-Balance-USD لمعرفة رصيدك المتبقي. مرجع الطلب الكامل موجود في الوثائق. إذا كنت تربط هذا في محرر، فإن الدليل الموجود في استخدام مفتاح API بنمط Kimi في Cursor يوضح مكان حقل عنوان URL الأساسي، ويشرح نظرة عامة على مفتاح Kimi API كيف ترتبط نقطة النهاية هذه بالنموذج الذي كنت تستخدمه.
المزيد من الأدلة
- عنوان URL الأساسي لـ Moonshot API: وجّه الكود إلى مكان آخر
- استخدم مفتاح API بأسلوب Kimi في Cursor: دليل الإعداد
الأسئلة الشائعة
هل النموذج هو نفسه Kimi الرسمي الخاص بـ Moonshot؟
لا، نحن نستضيف نموذج مفتوح الأوزان الذي تم ضبطه ليكون بدون رقابة. إنه ليس GPT، أو Claude، أو Gemini، أو Grok، أو DeepSeek، أو أي نموذج آخر من البائعين. إنه نموذج مميز يعمل على خوادمنا الخاصة.
هل تدربون على بياناتي؟
لا. لا تُستخدم الموجّهات والإكمال الخاصين بك في التدريب. نقدّر الخصوصية والشفافية، لذا تبقى بياناتك ملكاً لك.
ما هي حدود المعدل؟
محدود بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 MB. صُممت هذه الحدود لضمان أداء مستقر لجميع المستخدمين.
ما هي سياسة المحتوى؟
النموذج بدون رقابة فيما يتعلق بالمواضيع البالغة والجدلية والإبداعية. ومع ذلك، نحجب المحتوى الجنسي الذي يتضمن قاصرين. هذا حدّ صارم ينطبق دائماً، بغض النظر عن مستوى اشتراكك.
أسئلة وأجوبة
لماذا يعود مفتاحي الجديد بخطأ 401 فوراً؟
الأسباب الأكثر شيوعاً هي إرسال مفتاح إلى عنوان URL أساسي لمزوّد مختلف، وجود مسافة أو سطر جديد عالق في المفتاح المنسوخ، أو متغير بيئة يتجاوز كودك. اختبر باستخدام curl لاستبعاد تأثير SDK الخاص بك.
هل خطأ 429 يعني أن المفتاح غير صالح؟
لا. يعني الخطأ 429 أنك تجاوزت حد معدل الطلبات، أو حد التزامن، أو واجهت حملاً زائداً مؤقتاً. المفتاح صالح. انتظر قيمة Retry-After وقلل من الطلبات المتزامنة.
هل تكلف الطلبات الفاشلة مالاً هنا؟
لا. الطلبات الفاشلة أو المرفوضة لا تُفرض عليها رسوم على هذه نقطة النهاية، لذا فإن إعادة محاولة الطلب المعطوب لا تستنزف رصيدك.
هل يمكنني استخدام نقطة النهاية هذه كبديل مباشر لنموذج Kimi؟
يدعم نفس تنسيق الطلب الخاص بـ OpenAI، لذا فإن تغيير الكود يقتصر على تغيير عنوان URL الأساسي، والمفتاح، ومعرف النموذج uncensored. النموذج الأساسي مختلف، لذا لن تتطابق الاستجابات؛ اختبر الموجّهات الخاصة بك أولاً.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل بأكمله.