استخدام Kimi K2.6 عبر Moonshot API من دون الخلط في model ID

مسارات Moonshot الأساسية

تسلسل آمن لتشغيل Kimi K2.6

1. جهّز مفتاح Moonshot API. أمثلة Kimi تستخدم المصادقة عبر الترويسة Authorization: Bearer ...، كما تشرح وثائق TypingMind مسار إنشاء حساب Moonshot API، وإضافة رصيد، والحصول على API key.
2. اضبط العميل وفق نمط OpenAI-compatible. إذا كنت تستخدم OpenAI SDK، فالخطوة الحاسمة هي تغيير base_url إلى https://api.moonshot.ai/v1.
3. استدعِ /models قبل الطلب الحقيقي. هذا المسار مخصص لعرض النماذج المتاحة، ومثال الاستجابة يحتوي على الحقل id؛ وهذه هي القيمة التي ينبغي تمريرها في model.
4. أرسل طلب المحادثة باستخدام model وmessages. توضح وثائق Chat API بنية الطلب بهذه الحقول، بينما يحدد API Overview مسار /chat/completions.
5. افحص الرصيد أو استخدم batch عند الحاجة. توفر Kimi مساراً لفحص الرصيد، ومساراً آخر لإنشاء مهام batch.

مثال Python باستخدام OpenAI SDK

المثال التالي يستخدم 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)

مثال cURL: اجلب model ID أولاً ثم أرسل المحادثة

ابدأ بعرض النماذج المتاحة في حساب 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."}
    ]
  }'

فحص رصيد API

إذا فشل الطلب بسبب الفوترة، أو أردت التأكد من جاهزية الحساب قبل الدمج، فتوفر Kimi مسار فحص الرصيد /users/me/balance، وتستخدم الوثائق مثالاً يعتمد على Bearer token.

curl -sS https://api.moonshot.ai/v1/users/me/balance \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

لا تخلط معرفات Moonshot مع معرفات البوابات الوسيطة

بعض مزودي 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/models واستخدام قيمة id التي يعيدها 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.