| ملاحظة |
|---|
Authorization: Bearer ...base_url إلى https://api.moonshot.ai/v1. /models قبل الطلب الحقيقي. هذا المسار مخصص لعرض النماذج المتاحة، ومثال الاستجابة يحتوي على الحقل id؛ وهذه هي القيمة التي ينبغي تمريرها في model. model وmessages. توضح وثائق Chat API بنية الطلب بهذه الحقول، بينما يحدد API Overview مسار /chat/completions. المثال التالي يستخدم base_url الذي تنشره Kimi لاستخدام OpenAI SDK. أما المتغير
KIMI_MODEL_ID فيجب أن يكون قيمة id التي تحصل عليها من GET /models
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MOONSHOT_API_KEY"],
base_url="https://api.moonshot.ai/v1",
)
response = client.chat.completions.create(
model=os.environ["KIMI_MODEL_ID"],
messages=[
{"role": "user", "content": "مرحباً، عرّف نفسك باختصار."}
],
)
print(response)ابدأ بعرض النماذج المتاحة في حساب Moonshot/Kimi الخاص بك، لأن هذا المسار يعيد قائمة النماذج مع حقل id.
curl -sS https://api.moonshot.ai/v1/models \
-H "Authorization: Bearer $MOONSHOT_API_KEY"بعد اختيار قيمة id الصحيحة من الاستجابة، أرسل الطلب إلى Chat Completions. مسار /chat/completions وبنية الطلب القائمة على model وmessages واردان في وثائق Kimi.
curl -sS https://api.moonshot.ai/v1/chat/completions \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "PASTE_MODEL_ID_FROM_MODELS",
"messages": [
{"role": "user", "content": "اكتب فقرة قصيرة تعرّف Kimi K2.6."}
]
}'إذا فشل الطلب بسبب الفوترة، أو أردت التأكد من جاهزية الحساب قبل الدمج، فتوفر Kimi مسار فحص الرصيد /users/me/balance، وتستخدم الوثائق مثالاً يعتمد على Bearer token.
curl -sS https://api.moonshot.ai/v1/users/me/balance \
-H "Authorization: Bearer $MOONSHOT_API_KEY"بعض مزودي API الوسيطين يستخدمون معرفات خاصة بهم لنموذج Kimi K2.6. على سبيل المثال، تستخدم AIMLAPI المسار https://api.aimlapi.com/v1/chat/completions مع النموذج moonshot/kimi-k2-6. أما OpenRouter فيعرض النموذج باسم
moonshotai/kimi-k2.6 على صفحة API الخاصة به.
هذه المعرفات صحيحة داخل البوابة التي تعلنها فقط. فإذا كنت تستدعي المسار الرسمي https://api.moonshot.ai/v1/chat/completions، فالطريقة الأقل مخاطرة هي استدعاء GET https://api.moonshot.ai/v1/modelsid التي يعيدها Moonshot لحسابك.
اجعل سير العمل بسيطاً: احصل على API key، اضبط base_url في OpenAI SDK على https://api.moonshot.ai/v1، استدعِ /models للتحقق من معرّف Kimi K2.6 المتاح لحسابك، ثم أرسل الطلب إلى /chat/completions باستخدام model وmessages. بهذه الطريقة تلتزم بوثائق Kimi المتوافقة مع OpenAI، وتتجنب الخطأ الشائع: نسخ model ID من AIMLAPI أو OpenRouter ثم استخدامه كما هو على endpoint الرسمي الخاص بـ Moonshot.