AR ▾
احصل على مفتاح API

kimiapikey.comالدليل

استخدام مفتاح API بأسلوب Kimi في Cursor: دليل الإعداد

يمكن لـ Cursor التحدث مع أي نقطة نهاية متوافقة مع OpenAI، لذا فإن ربطها بواجهة برمجة التطبيقات هذه يتطلب أربعة حقول وحوالي دقيقتين. يغطي هذا الدليل القيم الدقيقة، واختبارًا يثبت أن المفتاح يعمل، والأخطاء التي من المرجح أن تواجهها.

تم التحديث

رسم توضيحي متساوي الأبعاد لمحرر رمز مرتبط بكابل متوهج بخادم واجهة برمجة التطبيقات

نقاط رئيسية

  • يحتاج Cursor إلى ثلاث قيم: مفتاحك، عنوان URL الأساسي https://api.kimiapikey.com/v1 واسم النموذج uncensored.
  • اختبر المفتاح باستخدام curl أولاً، حتى يكون من السهل التمييز بين مشكلة جانب Cursor ومشكلة جانب واجهة برمجة التطبيقات.
  • تقوم تعديلات بأسلوب الوكيل بإرسال موجّهات كبيرة، لذا راقب رموز الإدخال: $0.15 لكل مليون رمز وارد، و $0.50 لكل مليون رمز صادر.
  • يتيح مفتاح التجربة طلبين متزامنين، وهو ما يمكن أن يتجاوزه وكيل Cursor. يسمح المفتاح الكامل بـ 8.

الإجابة المختصرة

إذا كنت تبحث عن كيفية استخدام مفتاح kimi api في cursor، فإن أول شيء يجب معرفته هو أن المفتاح الصادر من مزوّد آخر يعمل فقط مع نقطة النهاية الخاصة بذلك المزوّد. يعمل المفتاح من هذا الموقع مع نقطة نهاية هذا الموقع، ويقبله Cursor لأن نقطة النهاية تتحدث بتنسيق chat completions الخاص بـ OpenAI. تلصق المفتاح، وتوجه Cursor إلى عنوان URL أساسي مختلف، وتضيف اسم نموذج مخصص واحدًا.

إعداد كامل بالترتيب:

  1. أنشئ حسابًا وانسخ مفتاحك من صفحة مفتاح API.
  2. افتح Cursor، ثم انتقل إلى الإعدادات، ثم النماذج.
  3. الصق المفتاح في حقل مفتاح OpenAI API.
  4. فعّل تجاوز عنوان URL الأساسي وأدخل https://api.kimiapikey.com/v1.
  5. أضف نموذجًا مخصصًا باسم uncensored وحدده في الدردشة.

يشرح بقية هذا المقال كل خطوة، ويوفر لك طريقة لاختبار الاتصال خارج محرر النصوص، ويذكر ما يحدث عادةً من أخطاء.

ما هو هذا المفتاح وما ليس هو

يبيع هذا الموقع الوصول إلى نموذج واحد مفتوح الأوزان، يشغله مزوّد مستقل ومُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس واجهة برمجة التطبيقات الرسمية لـ Moonshot أو Kimi أو أي بائع آخر، وهو ليس موجّهًا يعيد توجيه طلبك إلى نموذج طرف آخر. يعكس اسم الموقع ما يبحث عنه الناس، وليس من يدير الخدمة. إذا كنت تحمل بالفعل مفتاحًا من بائع آخر، فاستمر في استخدامه مع نقطة نهاية ذلك المزوّد. المفتاحان ليسا قابلين للتبديل.

ما تحصل عليه هو واجهة برمجة التطبيقات بتنسيق OpenAI العادي: POST /v1/chat/completions و GET /v1/models، ومصادقة رمز حامل، ونافذة سياق بحجم 100,000 رمز، والبث المتدفق، واستدعاء الدوال، ووضع JSON. النص فقط. لا يوجد توليد صور، ولا تضمينات، ولا ضبط دقيق، وهو أمر مهم في محرر لأن ميزات Cursor التي تعتمد على تلك الميزات لن تستخدم نقطة النهاية هذه. يذهب مُفسّر مفتاح Kimi API إلى التسمية والخيارات الأخرى بتفصيل أكبر.

بالنسبة للبرمجة، فإن "uncensored" له معنى عملي. لن يتوقف النموذج في منتصف المهمة لأن اسم متغير أو أداة اختبار تبدو حساسة. أدوات الأمان للأنظمة التي تمتلكها، ومحللات السجلات المليئة بسلاسل نصية غير أنيقة، وأدوات كشط البيانات (scrapers)، ومولدات الخيال، ومجموعات اختبار الإشراف على المحتوى هي أنواع المهام التي تسبب رفضًا في أماكن أخرى. يظل الحد الصارم ساريًا: لا محتوى جنسي يتضمن القاصرين، على الإطلاق.

الإعداد خطوة بخطوة في Cursor

1. احصل على المفتاح ورصيد التجربة المجاني

سجّل باستخدام Google، أو باستخدام بريد إلكتروني وكلمة مرور. في صفحة مفتاح API، يمكنك الحصول على $0.50 من رصيد التجربة المجاني بنقرة واحدة. لا يتطلب بطاقة، ويستمر لمدة 7 أيام، وهو واحد لكل شخص. هذا يكفي لبضع مئات من طلبات الدردشة العادية، بحيث يمكنك إكمال هذا الدليل بأكمله قبل دفع أي مبلغ.

2. افتح إعدادات النموذج

في Cursor، افتح الإعدادات وابحث عن قسم النماذج. تتغير تسميات القوائم بين الإصدارات، لذا ابحث عن حقل مخصص لمفتاح OpenAI API ومفتاح أو حقل مخصص لتجاوز عنوان URL الأساسي لـ OpenAI. هذان الإعدادان هما المهمان.

3. املأ القيم الثلاث

حقل Cursorالقيمة
مفتاح OpenAI APIمفتاحك من لوحة التحكم
تجاوز عنوان URL الأساسي لـ OpenAIhttps://api.kimiapikey.com/v1
اسم النموذج المخصصuncensored

أدخل عنوان URL الأساسي بالضبط كما هو موضح. ينتهي بـ /v1، بدون شرطة مائلة في النهاية وبدون /chat/completions، لأن العميل يضيف المسار بنفسه. يؤدي لصق عنوان URL مع المسار الكامل إلى خطأ 404، ورسالة الخطأ نادرًا ما توضح السبب.

4. حدد النموذج وأرسل رسالة

افتح لوحة الدردشة، واختر uncensored من قائمة النماذج، واسأل شيئًا صغيرًا، مثل "اكتب دالة تقوم بتحليل تواريخ ISO". إذا بدأت الاستجابة في الظهور بشكل متدفق، فقد انتهيت. إذا أظهر Cursor خطأً، فلا تغير الإعدادات بشكل عشوائي. انتقل إلى القسم التالي واختبر نقطة النهاية مباشرة.

5. اعرف الأثر الجانبي للتجاوز

يُطبق تجاوز عنوان URL الأساسي عادةً على كل نموذج على طراز OpenAI تستخدمه في Cursor، وليس فقط المخصص. إذا عدت لاحقًا إلى نموذج OpenAI القياسي، فأوقف تجاوز عنوان URL الأساسي أولاً، وإلا فسيذهب طلبك إلى نقطة النهاية هذه باسم نموذج لا يخدمه.

اختبر المفتاح قبل إلقاء اللوم على المحرر

دقيقتان في الطرفية (terminal) توفران ساعة من التخمين. هذا الطلب يقوم بما يفعله Cursor: وهو إرسال طلب chat completion مع رمز حامل (bearer token).

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ready."}],
    "max_tokens": 20
  }'

يعني جسم JSON الذي يحتوي على مصفوفة choices أن المفتاح، وعنوان URL، واسم النموذج جميعها صحيحة. تحقق أيضاً من رؤوس الاستجابة. يُظهر X-Balance-USD رصيدك المتبقي، بينما يُعد X-Request-Id مفيداً للاحتفاظ به إذا احتجت يوماً إلى تتبع طلب.

نفس الفحص في Python باستخدام الـ SDK الرسمي من OpenAI:

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": "user", "content": "Reply with the word ready."}],
    max_tokens=20,
)
print(resp.choices[0].message.content)

يمكنك أيضاً سرد النماذج باستخدام GET /v1/models. أحياناً يستدعي Cursor وعملاء آخرون هذا المسار عند الضغط على زر التحقق، لذا فإن نجاح استدعاء النماذج علامة جيدة. إذا نجح curl ولم ينجح Cursor، فالمشكلة في إعدادات المحرر، ويغطي الجدول أدناه الأخطاء الشائعة.

ما الذي يتغير عندما يكتب النموذج الكود في محررك

الدردشة في لوحة جانبية رخيصة. تكلفة سؤال قصير مع بضع مئات من الرموز من السياق تكلف جزءاً بسيطاً من سنت واحد. تكلف ميزات المحرر التي ترفق الملفات ونتائج البحث وسجل المحادثة أكثر لأن كل طلب يحمل كل شيء مرة أخرى. للنموذج نافذة بحجم 100,000 رمز مشتركة بين الموجّه والاستجابة، وسيملأ Cursor الكثير منها بكل سرور إذا أرفقت مجلدًا كبيرًا.

إليك حساب حقيقي. لنفترض أن الطلب يحمل 40,000 رمز إدخال وأن النموذج يكتب 1,500 رمز استجابة:

  • الإدخال: 40,000 / 1,000,000 × $0.15 = $0.006
  • الإخراج: 1,500 / 1,000,000 × $0.50 = $0.00075
  • المجموع: $0.00675 لكل طلب، لذا فإن 100 طلب من هذا النوع تكلف $0.675

هذا أقل بكثير من دولار ليوم مشغول، لكن جانب الإدخال يهيمن، لذا فإن العادة التي توفر المال هي إرفاق ملفات أقل، وليس طرح أسئلة أقصر. ابدأ دردشة جديدة عندما يتغير الموضوع، لأن السجل القديم يُدفع ثمنه مرة أخرى في كل دور.

يدعم API استدعاء الدوال (function calling)، وهو ما تعتمد عليه ميزات المحرر على نمط الوكلاء. يقرر النموذج استدعاء أداة، ويقوم عميلك بتشغيلها ويعيد النتيجة كرسالة role: "tool". تعتمد جودة قيادة أي نموذج لوكيل متعدد الخطوات على النموذج نفسه، لذا جربه على مهمة صغيرة قبل أن تفوضه إجراء إعادة هيكلة. يعني وجود نموذج واحد مفتوح الأوزان خلف الـ API أنك تحصل على سلوك واحد، وليس قائمة للاختيار من بينها.

ميزات Cursor التي تعمل على نماذج Cursor الخاصة، مثل الإكمال التلقائي بزر Tab، لا يتم تبديلها عادةً بمفتاح مخصص. تحقق من وثائق Cursor الحالية لمعرفة الميزات التي تقبل نقطة نهاية متوافقة مع OpenAI، لأن هذه القائمة تتغير بين الإصدارات.

الأخطاء الشائعة وكيفية إصلاحها

العرضالسبب المحتملالحل
404 أو "غير موجود"يتضمن عنوان URL الأساسي مسار نقطة النهاية، أو يفتقر إلى /v1استخدم بالضبط https://api.kimiapikey.com/v1
401 غير مصرحمسافة زائدة أو سطر جديد في المفتاح الملصق، أو مفتاح قديمانسخ المفتاح مرة أخرى من لوحة التحكم وألصقه مجدداً
النموذج غير موجودكُتب اسم النموذج بشكل مختلفاستخدم uncensored، بحروف صغيرة، ولا شيء آخر
429 مع رمز concurrencyطلبات كثيرة جداً في وقت واحد لمفتاحكانتظر حتى تنتهي الطلبات الجارية، أو استخدم مفتاحًا كاملاً (8 طلبات متزامنة)
خطأ 429 مع الرمز rate_limitedأكثر من المسموح به في الدقيقةأبطئ؛ تسمح المفاتيح التجريبية بـ 60 طلب في الدقيقة، والمفاتيح الكاملة بـ 300
429 مع رأس Retry-After: 5حمل زائد مؤقتأعد المحاولة بعد خمس ثوانٍ
فشل زر التحقق، لكن curl يعمليختبر المحرر باستخدام اسم نموذج يعرفهتخطِ خطوة التحقق وأرسل رسالة دردشة حقيقية

يستحق خطأ التزامن ملاحظة لأنه يفاجئ المستخدمين في مفتاح التجربة. تسمح التجربة بطلبين متزامنين، ويمكن أن يتجاوز الوكيل الذي يبدأ عدة عمليات بالتوازي ذلك دون أي إجراء منك. كما أن الاستجابة المتدفقة تحتفظ بمكانها حتى ينتهي البث، لذا فإن الإجابة الطويلة تشغل مكاناً واحداً طوال الوقت. يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة، وهو ما يكفي لمطور واحد.

الطلبات الفاشلة والمرفوضة لا تُحسب، لذا فإن إعادة المحاولة بعد الخطأ لا تكلف شيئًا إضافيًا. يمكنك الاطلاع على الحدود الكاملة في صفحة التوثيق.

الدفع له بمجرد نفاد الرصيد التجريبي

لا يوجد اشتراك. تقوم بشحن رصيد مسبق الدفع بأي مبلغ صحيح يتراوح بين $20 و$500، ويتم خصم الطلبات منه بمعدل $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مُنتَج. الرصيد لا ينتهي، لذا فإن شهرًا بدون كتابة أكواد لا يكلف شيئًا. الشحنات بمبلغ $50 أو أكثر تشمل مكافأة: +5% من $50، و+10% من $100، و+15% من $200. يمكنك الدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base). تحتوي صفحة الأسعار على الأرقام الحالية في مكان واحد.

باستخدام الطلب السابق الذي يحتوي على 40,000 رمز مدخل و1,500 رمز مُنتَج، يغطي شحن بمبلغ $20 حوالي 2,960 طلبًا من هذا النوع ($20 / $0.00675). معظم طلبات المحرر أصغر من ذلك، لذا فإن الرقم الفعلي أعلى. لا تُستخدم الموجّهات الخاصة بك في التدريب، وهو أمر مهم عندما ينتمي الكود الذي تلصقه إلى عميل.

عند الانتهاء من الإعداد، تكون المهمة الأولى المعقولة هي مهمة صغيرة يمكنك مراجعتها بسرعة: اختبار وحدة لدالة موجودة، أو تعبير منتظم مع تعليق طويل، أو إعادة كتابة ملف واحد صاخب. إذا كانت النتائج تناسب سير عملك، أضف رصيدًا. إذا لم تكن كذلك، فقد أنفقت بضعة سنتات من الرصيد التجريبي لاكتشاف ذلك.

الأسئلة الشائعة

هل النموذج هو نفسه Kimi الرسمي الخاص بـ Moonshot؟
لا، نحن نستضيف نموذجًا مفتوح الأوزان تم ضبطه ليكون بدون رقابة. إنه ليس GPT، أو Claude، أو Gemini، أو Grok، أو DeepSeek، أو أي نموذج آخر من البائعين. إنه نموذج مميز يعمل على خوادمنا الخاصة.

هل تدربون على بياناتي؟
لا. لا تُستخدم الموجّهات والإكمال الخاصين بك في التدريب. نقدّر الخصوصية والشفافية، لذا تبقى بياناتك ملكاً لك.

ما هي حدود المعدل؟
محدود بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 MB. صُممت هذه الحدود لضمان أداء مستقر لجميع المستخدمين.

ما هي سياسة المحتوى؟
النموذج بدون رقابة فيما يتعلق بالمواضيع البالغة والجدلية والإبداعية. ومع ذلك، نحجب المحتوى الجنسي الذي يتضمن قاصرين. هذا حدّ صارم ينطبق دائماً، بغض النظر عن مستوى اشتراكك.

أسئلة وأجوبة

هل يمكنني وضع مفتاح Moonshot أو Kimi في Cursor باستخدام عنوان URL الأساسي هذا؟

لا. يعمل المفتاح فقط مع نقطة النهاية الخاصة بمقدم الخدمة الذي أصدره. استخدم المفتاح من لوحة التحكم هنا، أو احتفظ بالمفتاح الآخر مع عنوان URL الخاص بمقدم الخدمة الخاص به.

ما اسم النموذج الذي أدخله في Cursor؟

أدخل uncensored، بحروف صغيرة. إنه معرف النموذج الوحيد الذي تقدمه هذه API، ويعيد الاسم المختلف خطأ "نموذج غير موجود".

هل يعمل مع وضع وكيل Cursor؟

تدعم API استدعاء الدوال، وهو ما تحتاجه ميزات الوكيل. تختلف موثوقية إكمال النموذج للمهام الطويلة متعددة الخطوات، لذا اختبره على مهمة صغيرة قبل المهمة الكبيرة.

لماذا أحصل على خطأ 429 في المفتاح التجريبي؟

يسمح مفتاح التجربة بطلبين متزامنين و60 طلب في الدقيقة. يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة، ويعني رأس HTTP Retry-After: 5 وجود حمل زائد قصير يمكنك إعادة المحاولة بعده.

هل يُستخدم كودي في التدريب؟

لا. لا تُستخدم الموجّهات المرسلة إلى الواجهة في التدريب.

مفتاحك على بُعد استمارة واحدة

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد كله.

احصل على مفتاح APIاقرأ الوثائق