kimiapikey.comالدليل
عنوان URL الأساسي لواجهة Moonshot API: وجّه كودك إلى مكان آخر
عنوان URL الأساسي لواجهة moonshot api هو مجرد سلسلة نصية واحدة في عميلك على طراز OpenAI، وتغييره هو الطريقة التي توجه بها نفس الكود إلى مزود مختلف. توضح هذه الصفحة أين توجد هذه السلسلة في Python وNode وcurl والأدوات الشائعة، وكيفية توجيهها إلى نقطة نهاية بديلة.
تم التحديث


نقاط رئيسية
- عنوان URL الأساسي هو إعداد واحد؛ تظل جسم الطلب بتنسيق دردشة OpenAI.
- غيّر ثلاثة أشياء عند التبديل: عنوان URL الأساسي، ومفتاح API، ومعرف النموذج.
- نقطة النهاية لدينا هي https://api.kimiapikey.com/v1 ومعرف النموذج هو uncensored.
- إنه نموذج مستضاف بشكل مستقل، وليس الخدمة الرسمية لـ Moonshot، لذا أعد اختبار المطالبات الخاصة بك.
ما يفعله عنوان URL الأساسي فعليًا
يبني كل عميل متوافق مع OpenAI كل طلب من جزأين: عنوان URL الأساسي ومسار. يدمج SDK هذين الجزأين، لذا تصبح المكالمة إلى chat.completions.create طلب POST إلى <base_url>/chat/completions. ينشر المزودون الذين يتبعون هذا التنسيق، بما في ذلك Moonshot، عنوان URL الأساسي الخاص بهم في وثائقهم. ابحث عنه هناك بدلاً من نسخه من منشور في منتدى، لأنه القيمة الوحيدة التي لا يمكن تخمينها.
لذلك يتطلب التبديل بين المزودين ثلاث تعديلات فقط:
- عنوان URL الأساسي، الذي يحدد وجهة الطلب.
- مفتاح API، الذي يُصدر لكل مزوّد ويعمل فقط على خوادم ذلك المزوّد.
- معرف النموذج، لأن كل مزوّد يسمي نماذجه بشكل مختلف.
تظل الرسائل والأدوار والبث المتدفق والأدوات ووضع JSON بنفس الشكل، وهذا هو سبب قصر مدة الترحيل. أي شيء يعتمد على ميزة خاصة بالمزوّد، مثل أداة بحث ويب مدمجة، سيتطلب معالجة منفصلة.
يساعد أيضًا الاحتفاظ بالقيم الثلاث معًا في كتلة إعدادات واحدة أو ملف بيئة واحد لكل مزوّد. عندما يجلس عنوان الـ Base URL والمفتاح ومعرف النموذج جنبًا إلى جنب، فإن العودة إلى الخلف تكون تغييرًا في سطر واحد، وتتجنب حالة الترحيل الناقصة حيث يُقترن مفتاح جديد بعنوان قديم.
بايثون: حزمة openai
في Python، تضبط عنوان URL الأساسي عند إنشاء العميل. هذا المثال يتصل بنقطة النهاية في هذا الموقع:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
إذا كنت تفضل إبقاء الكود خاليًا من الإعدادات، فاستخدم البيئة بدلاً من ذلك. يقرأ الـ SDK OPENAI_BASE_URL و OPENAI_API_KEY عندما تستدعي OpenAI() بدون وسائط، لذا يمكن لنشر ما أن يبدل المزوّدين دون تغيير في الكود. كن على علم بأن هذا يعني أيضًا أن متغيرًا متبقيًا في سطر الأوامر الخاص بك يمكن أن يتجاوز قيمة كتبتها في الملف.
Node و curl
تستخدم الحزمة الرسمية لـ JavaScript نفس اسم الخيار، مكتوبًا بحالة الجمل:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
بدون أي SDK على الإطلاق، يكون عنوان URL الأساسي ببساطة بداية العنوان:
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":"Hello"}]}'
تقبل نقطة النهاية نفسها أيضًا POST /v1/responses، و GET /v1/models يسرد ما تقدمه. المصادقة هي رمز حامل في رأس Authorization في كل حالة.
محررات وواجهات الدردشة
تعرض أدوات واجهة المستخدم عنوان الـ Base URL تحت تسميات مختلفة: "API base"، "Override OpenAI Base URL"، "Custom endpoint" أو "Provider URL". القيمة التي تلصقها هي نفس السلسلة كما في الكود أعلاه، وتنتهي عند /v1. لا تلصق عنوان /chat/completions الكامل إلا إذا قالت الأداة إنها تريد عنوان URL الكامل.
بعد الحفظ، أضف معرف النموذج يدويًا إذا لم تكن الأداة تجلب قائمة. بعض المحررات تحقق من صحة المفتاح مقابل مزوّد ثابت وترفض القيم المخصصة، وفي هذه الحالة ابحث عن إعداد يفعّل وضع المخصص أو متوافق مع OpenAI أولاً. تشرح المقالة حول استخدام مفتاح API على طراز Kimi في Cursor أداة من هذا القبيل بالتفصيل.
ما الذي يتغير عند تبديل المزوّد
تنسيق مطابق لا يعني سلوكًا مطابقًا. قبل نقل حركة الإنتاج، تحقق من هذه النقاط واحدة تلو الأخرى:
- أسلوب الإخراج. يكتب نموذج مختلف بشكل مختلف. شغّل الموجّه الحقيقي الخاص بك، وليس مثالًا بسيطًا.
- حجم السياق. نقطة النهاية هذه لديها نافذة سياق من 100,000 رمز للموجّه بالإضافة إلى الإكمال. إذا كان إعدادك الحالي يرسل موجّهات أطول، فقم بتقليصها أولاً.
- الحدود. يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 في الدقيقة. تجاوز أي من هذين الحدين يعطيك HTTP 429، مع
rate_limitedأوconcurrencyكرمز الخطأ. - الميزات. البث عبر SSE، استدعاء الدوال ووضع JSON مدعومان. توليد الصور والصوت والفيديو، التضمينات والضبط الدقيق غير مدعومين؛ هذه واجهة برمجة للنصوص فقط.
- التسمية. تعمل الخدمة على نموذج مفتوح الأوزان واحد مُختار للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. إنها ليست واجهة برمجة Moonshot الرسمية وليست موزعًا عبر المزوّدات.
طريقة محايدة للمقارنة هي تسجيل نفس عشرة موجّهات عبر كلتا نقطتي النهاية وقراءة الإجابات جنبًا إلى جنب. يستغرق ذلك دقائق ويوفر التخمين.
أخطاء عنوان URL الأساسي وكيف تبدو
تأتي معظم الأخطاء بعد التبديل من العنوان، وليس من المفتاح. إليك كيف يظهر كل خطأ وكيف تصلحه.
| خطأ | العرض | الحل |
|---|---|---|
المضيف فقط، بدون /v1 | خطأ 404 في كل استدعاء | أضف /v1 إلى النهاية |
| تم لصق المسار الكامل | خطأ 404 مع مسار مكرر في رسالة الخطأ | اختصار العنوان إلى /v1 |
| شرطة مائلة في النهاية بالإضافة إلى دمج المسارات يدوياً | شرطتان مائلتان في عنوان URL | دع مكتبة SDK تدمج المسار |
| مفتاح قديم، عنوان URL جديد | 401 | استخدم المفتاح الذي أصدره المزود الجديد |
| عنوان URL قديم، مفتاح جديد | خطأ 401 من المزود القديم | ابحث في المستودع وفي سطر الأوامر عن العنوان القديم |
http:// بدلاً من https:// | خطأ إعادة التوجيه أو الاتصال | استخدم https في كل مكان |
طريقة سريعة للعثور على العناصر المتبقية هي البحث في مشروعك وإعدادات النشر الخاصة بك عن اسم المضيف القديم. ابحث في ملفات .env، ومتغيرات CI، وملفات Docker compose، وأي إعدادات محرر، حيث يكفي وجود نسخة واحدة منسية لإرسال بعض حركة المرور إلى المزود القديم.
البث المتدفق والأدوات بعد التبديل
قم بتعيين stream: true ليصل الرد كحدث مرسل من الخادم، مع الإبلاغ عن استخدام الرموز في النهاية. يستخدم استدعاء الأدوات حقول tools و tool_choice المعتادة، مع إرسال استدعاءات tool_calls المتدفقة والنتائج كرسائل تحتوي على role: "tool". إذا كان كودك يتعامل مع هذه الميزات بالفعل للمزود القديم، فيجب أن يستمر في العمل؛ تأكد من ذلك بتشغيل استدعاء واحد متدفق واستدعاء أداة واحد قبل التبديل الكامل. تذكر أن الطلب المتدفق يحتفظ بفتحة التزامن الخاصة به حتى ينتهي البث.
فحص التكلفة قبل التبديل
الفوترة هنا تعتمد على الرمز: $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج، من رصيد مسبق الدفع، بدون اشتراك. الطلبات الفاشلة أو المرفوضة لا تُحسب تكلفتها، ولا ينتهي صلاحية الرصيد. لمعرفة أسعار مزود آخر، تحقق من صفحة الأسعار الحالية لديهم، حيث تتغير هذه الأسعار.
مثال مُفصّل. نفترض أن الطلب يحتوي على 2,000 رمز إدخال و 500 رمز إخراج:
- الإدخال: 2,000 / 1,000,000 × $0.15 = $0.0003
- الإخراج: 500 / 1,000,000 × $0.50 = $0.00025
- المجموع: $0.00055 لكل طلب، لذا فإن 1,000 طلب تكلف $0.55
أصغر عملية شحن هي $20، وتضيف الشحنات الأكبر مكافأة: +5% من $50، +10% من $100 و +15% من $200. يتم قبول العملات المشفرة فقط (USDT على TRC20، USDC على Base) للشحن. التفاصيل الكاملة موجودة في صفحة الأسعار، والتفصيل المخصص لـ Kimi موجود في أسعار مفتاح API الخاص بـ Kimi.
احصل على مفتاح API وقم بتشغيل أول مكالمة
سجّل باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور، ثم افتح صفحة مفتاح API. يمكن للمستخدمين الجدد المطالبة بمبلغ $0.50 من رصيد تجريبي بنقرة واحدة، لكل شخص، صالح لمدة 7 أيام ولا يتطلب بطاقة. مفاتيح التجربة محدودة بـ 2 طلبات متزامنة و 60 طلب في الدقيقة، وهو ما يكفي تماماً لاختبار التشغيل.
ألصق المفتاح في مقتطف بايثون أعلاه، شغّله، ثم تأكد من استلام النص. تُدرج الوثائق كل المعاملات، وتساعد رؤوس الاستجابة X-Request-Id وX-Balance-USD في تصحيح الأخطاء وتتبع الرصيد. لا تُستخدم الموجّهات المرسلة إلى الخدمة في التدريب.
المزيد من الأدلة
- مفتاح API الخاص بـ Kimi لا يعمل: الأسباب، الإصلاحات، الحل البديل
- استخدام مفتاح API بأسلوب Kimi في Cursor: دليل الإعداد
الأسئلة الشائعة
هل النموذج هو نفسه Kimi الرسمي الخاص بـ Moonshot؟
لا، نحن نستضيف نموذج مفتوح الأوزان الذي تم ضبطه ليكون بدون رقابة. إنه ليس GPT، أو Claude، أو Gemini، أو Grok، أو DeepSeek، أو أي نموذج آخر من البائعين. إنه نموذج مميز يعمل على خوادمنا الخاصة.
هل تدربون على بياناتي؟
لا. لا تُستخدم الموجّهات والإكمال الخاصين بك في التدريب. نقدّر الخصوصية والشفافية، لذا تبقى بياناتك ملكاً لك.
ما هي حدود المعدل؟
محدود بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 MB. صُممت هذه الحدود لضمان أداء مستقر لجميع المستخدمين.
ما هي سياسة المحتوى؟
النموذج بدون رقابة فيما يتعلق بالمواضيع البالغة والجدلية والإبداعية. ومع ذلك، نحجب المحتوى الجنسي الذي يتضمن قاصرين. هذا حدّ صارم ينطبق دائماً، بغض النظر عن مستوى اشتراكك.
أسئلة وأجوبة
هل أحتاج إلى تغيير الكود الخاص بي عند تغيير عنوان URL الأساسي؟
عادةً ما تكون القيم الثلاث فقط: عنوان URL الأساسي، ومفتاح API، ومعرف النموذج. تظل صيغة الرسالة، والبث المتدفق، واستدعاء الأدوات كما هي طالما أن المزوّد الجديد يدعمها.
هل يجب أن ينتهي الـ Base URL بـ /v1؟
نعم لهذه النقطة النهائية: https://api.kimiapikey.com/v1. يضيف SDK /chat/completions تلقائيًا، لذا لا تقم بتضمينه.
هل هذه هي API الرسمية من Moonshot؟
لا. إنه نموذج مفتوح الأوزان مستضاف بشكل مستقل خلف واجهة برمجة تطبيقات متوافقة مع OpenAI. إنه ليس خدمة Moonshot وليس وسيطًا بين مزوِّدي الخدمات.
أين أجد معرف النموذج؟
قم باستدعاء GET /v1/models بمفتاحك. عند هذه النقطة النهائية، يكون معرف النموذج uncensored.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.