كيفية استخدام Kimi K3.1 Pro

إليك كيفية استخدام Kimi K3.1 Pro بأربع طرق: الدردشة معه على تطبيق Kimi للويب أو الجوال، أو استدعاء kimi-k3.1-pro عبر واجهة API المتوافقة مع OpenAI على https://api.moonshot.ai/v1، أو تشغيله داخل Kimi Code CLI بعضوية مدفوعة، أو توجيه Codex أو Claude Code أو OpenCode إلى نقاط نهاية Moonshot. تُفتح واجهة API بعد شحن رصيد بقيمة $1 وتكلّف $2 لكل مليون رمز إدخال و$10 لكل مليون رمز إخراج.

أصدرت Moonshot AI نموذج Kimi K3.1 Pro في 23 أكتوبر 2026. وهو نسخة مُدرَّبة لاحقًا (post-trained) من Kimi K3 بالتصميم نفسه MoE بمعاملات 2.8T (بنحو 104B نشطة)، ونافذة سياق تبلغ 1,048,576 رمزًا، وتفكير مُفعَّل دائمًا. إذا أردت الخلفية أولًا، اقرأ ما هو Kimi K3.1 Pro. وإذا أردت ألا تدفع شيئًا، فإن دليلنا حول استخدام Kimi K3.1 Pro مجانًا يغطي المسارات بتكلفة $0. كل حقيقة أدناه مأخوذة من إعلان Moonshot، والبدء السريع لواجهة API وصفحة الأسعار، وقد قُرئت في 24 أكتوبر 2026.

أي مسار من Kimi K3.1 Pro يجب أن تختاره؟

اختر حسب ما تبنيه. الدردشة تناسب الأسئلة السريعة، وواجهة API تناسب التطبيقات، وKimi Code يناسب الأعضاء الذين يريدون وكيلًا دون مفتاح لإدارته، والوكيل الخاص بك يناسب الفرق التي تعمل أصلًا داخل Codex أو Claude Code.

استخدام Kimi K3.1 Pro في تطبيقات Kimi للويب والجوال

تطبيقات الدردشة هي أسرع طريقة للبدء. افتح تطبيق Kimi للويب أو تطبيق iOS أو Android أو HarmonyOS، وسجّل الدخول بحساب مجاني، وستجد K3.1 Pro هو النموذج الافتراضي بالفعل في محرر الإدخال، مع ضبط جهد التفكير على High.

قبل تسجيل الدخول، يعرض محرر الإدخال أيضًا K2.8 Preview وInstant. إرسال أي أمر نصي يتطلب حسابًا. ولا تنشر Moonshot حصة الرسائل الخاصة بـ K3.1 Pro في الخطة المجانية [VERIFY]، لذا تعامل مع الدردشة كساحة اختبار، لا كقناة إنتاجية.

كما يشغّل Kimi Work لسطح المكتب إصدار 3.1.0 وما بعده (ويندوز وأجهزة Mac بشرائح Apple silicon) النموذج. وفي Kimi Business وEnterprise، يجب على المسؤول تفعيله، لأنه معطّل افتراضيًا عند الإطلاق.

واجهة API لـ Kimi K3.1 Pro: أول استدعاء بلغة Python وcURL

واجهة API الخاصة بـ Kimi K3.1 Pro متوافقة مع OpenAI، لذا تعمل حزمة openai القياسية مع تغيير عنوان URL الأساسي. يتطلب الإعداد ثلاث خطوات:

1. اشحن رصيدًا لا يقل عن $1. إن K3.1 Pro نموذج رائد ولا يُفتح إلا بعد شحن ناجح.
2. أنشئ مفتاحًا في لوحة مفاتيح API وصدّره باسم MOONSHOT_API_KEY.
3. استدعِ النموذج kimi-k3.1-pro (أو kimi-k3.1-pro-highspeed) على https://api.moonshot.ai/v1.

إليك مثال Moonshot الرسمي بلغة Python:

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["MOONSHOT_API_KEY"], base_url="https://api.moonshot.ai/v1")
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)
print(completion.choices[0].message.content)

الاستدعاء نفسه عبر cURL:

curl https://api.moonshot.ai/v1/chat/completions \
  --header "Authorization: Bearer $MOONSHOT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model": "kimi-k3.1-pro","reasoning_effort": "high","messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]}'

يستقبل النموذج النصوص والصور والفيديو كمدخلات (يوضح البدء السريع جزئي image_url وvideo_url) ويعيد نصًا. يمكنك أيضًا تجربة الأوامر النصية في Playground قبل كتابة الكود. وللاطلاع على أنماط عصر K3 التي ما زالت سارية، راجع دليل Kimi K3 API.

جهد التفكير في Kimi K3.1 Pro: low أو high أو max

حقل reasoning_effort هو حقل طلب بمستوى أعلى يحدد مقدار تفكير النموذج قبل الإجابة. يقبل القيم "low" و"high" و"max"، والقيمة الافتراضية هي "max". لا يمكن إيقاف التفكير. ولا يوجد مستوى "medium".

يتضمن دليل جهد التفكير من Moonshot المرجع الكامل. ولأنك تدفع مقابل رموز الإخراج بمعدل $10 لكل مليون، فإن خفض المستوى من max إلى low في الاستدعاءات البسيطة هو أسهل توفير ستجده. اترك حقلي temperature وtop_p: إذ يدرجهما البدء السريع كقيم ثابتة عند 1.0 و0.95.

بث التفكير، والحفاظ على حالة تعدد الأدوار، واستعادة JSON

هناك ثلاثة سلوكيات في واجهة API تربك المستخدمين، ولكل منها قاعدة بسيطة.

البث. يرسل الرد المُبثَّث فروقًا منفصلة لـ reasoning_content وcontent. اعرض أو سجّل الأول، واعرض الثاني:

stream = client.chat.completions.create(
    model="kimi-k3.1-pro", reasoning_effort="low", stream=True,
    messages=[{"role": "user", "content": "Explain MoE routing briefly."}],
)
for chunk in stream:
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="")
    if delta.content:
        print(delta.content, end="")

تعدد الأدوار واستدعاءات الأدوات. أرسل رسالة المساعد الكاملة، وليس content فقط. وثائق Moonshot صريحة في هذا، وهو أمر بالغ الأهمية عند وجود استدعاءات أدوات:

messages.append(completion.choices[0].message)  # whole message, not .content
messages.append({"role": "user", "content": "Now add tests."})

الحقل tool_choice: "required" مدعوم عندما تحتاج إلى أن يستدعي النموذج أداة. والوضع الجزئي يعمل أيضًا: أنهِ رسائلك برسالة مساعد تحمل "partial": true وسيكملها النموذج.

المخرجات المُهيكلة. مرّر response_format بنوع json_schema وstrict: true، ثم حلّل message.content فقط. لا تحلّل نص التفكير أبدًا.

Kimi Code K3.1 Pro: مسار العضوية

Kimi Code هو وكيل البرمجة الطرفي الخاص بـ Moonshot، وهو المسار الذي لا يحتاج إلى مفتاح API. إذ تسجّل الدخول بحساب Kimi الخاص بك بدلًا من ذلك. وهو ميزة ضمن العضوية، لذا لا تتضمنه خطة Adagio المجانية.

ثبّته وسجّل الدخول:

# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# Windows PowerShell: irm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi

داخل الجلسة، نفّذ /login، ثم /model لاختيار K3.1 Pro. ويقابل المعرّفان مستويات الخطط:

• k3.1-pro: لخطة Moderato (Plus) وما فوق. وتفتح Allegretto (Pro) وما فوق سياقًا يصل إلى 1M.
• k3.1-pro-highspeed: لخطة Allegretto (Pro) وما فوق، باستهلاك يقارب ضعف الحصة.

وفق أسعار العضوية، تبلغ Plus $15 شهريًا عند الفوترة السنوية ($19 شهريًا) وPro $31 سنويًا ($39 شهريًا). وتغطي وثائق Kimi Code الأوامر، ويغوص شرح Kimi Code CLI الخاص بنا أعمق في الاستخدام اليومي.

Kimi K3.1 Pro في Codex

يتحدث Codex إلى Kimi عبر واجهة Responses API، وتنشر Moonshot دليل Codex الرسمي. أضف هذا إلى ~/.codex/config.toml:

model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

لاحظ اسم متغير البيئة: يقرأ Codex المتغير KIMI_API_KEY، وليس MOONSHOT_API_KEY. صدّر مفتاح Moonshot الخاص بك بهذا الاسم، ثم شغّل codex كالمعتاد.

Kimi K3.1 Pro في Claude Code

تشغّل Moonshot نقطة نهاية Messages متوافقة مع Anthropic على https://api.moonshot.ai/anthropic، لذا يعمل Claude Code دون وسيط. ضع المتغيرات في كتلة env داخل ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]"
  }
}

الاسم المستعار مقصود. تقول صفحة استكشاف الأخطاء من Moonshot إن استدعاءات API المباشرة وCodex تستخدم kimi-k3.1-pro، بينما يستخدم Claude Code الاسم المستعار المتوافق kimi-k3[1m]. ويضبط دليل Claude Code متغيرات النموذج الأخرى أيضًا، فانسخها منه.

وهناك مأزق واحد: القيم القديمة في كتلة env بملف الإعدادات تتجاوز متغيرات الصدفة (shell). إذا استمر Claude Code في استدعاء نموذج قديم، فافحص ذلك الملف أولًا.

OpenCode

لا يحتاج OpenCode إلى ملف إعدادات. نفّذ opencode auth login، واختر “Moonshot AI”، والصق مفتاحك، ثم اختر K3.1 Pro من نماذج Moonshot AI. وقد كُتب دليل OpenCode من Moonshot لنموذج K3، لذا تأكد من ظهور النموذج في قائمتك [VERIFY].

دع وكيلك يختبر Kimi API باستخدام Apidog CLI

بمجرد أن يعمل Codex أو Claude Code على K3.1 Pro، شغّل الجلسة نفسها في اختبارات الانحدار الخاصة بواجهة Kimi API نفسها. يكتب وكيلك الفحوصات ويشغّلها؛ وأنت تكتب أمرًا نصيًا واحدًا. يمنحه Apidog CLI مخرجات JSON منظمة ومخططات، فلا يخمّن أشكال البيانات المُرسلة.

ثبّت أداة CLI، وسجّل الدخول، وأضف مهارة الوكيل:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
apidog skill install

ثم أعطِ وكيلك أمرًا نصيًا واحدًا:

In Apidog project <projectId>, create an environment for https://api.moonshot.ai/v1.
Then create a test case for POST /chat/completions with model kimi-k3.1-pro and
reasoning_effort "low" that asserts status 200 and non-empty choices[0].message.content.
Run it and summarize any failures.

ينشئ الوكيل البيئة، ويقرأ المخطط، ويتحقق من صحة بياناته المُرسلة، ويكتب حالة الاختبار ويشغّلها:

apidog environment create kimi-prod --project <projectId> --base-url https://api.moonshot.ai/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

تحتاج حالات الاختبار إلى تصنيف صالح، ويسرد أمر apidog test-case category --project <projectId> التصنيفات المتاحة. كما أن استجابة 200 مع إجابة غير فارغة تثبت أيضًا أن واجهة API قبلت reasoning_effort. استبدل -r junit وسيندرج التشغيل نفسه في CI، كما يوضح دليل Apidog CLI لـ CI/CD. أما الإعداد الخاص بالوكيل فيوجد في Apidog CLI في Codex وApidog CLI في Claude Code. وتغطي خطة Apidog المجانية ما يصل إلى 4 مستخدمين.

ملاحظات على تكلفة Kimi K3.1 Pro

واجهة API تعمل بالدفع حسب الاستخدام، دون اشتراك، والأسعار لا تشمل الضريبة.

إن K3.1 Pro أرخص بثلث الثمن من K3 في الإدخال والإخراج. التخزين المؤقت تلقائي للبادئات المتكررة، بمدة صلاحية افتراضية 5 دقائق، وتُحتسب إصابات الذاكرة المؤقتة بـ $0.20. أما Highspeed فيعمل أسرع بمرتين إلى ثلاث مرات مقابل ضعف السعر.

شحنك الأدنى بقيمة $1 يشتري نحو 500 ألف رمز إدخال أو 100 ألف رمز إخراج. وعندما تبلغ قيمة شحناتك التراكمية $5، تحصل على قسيمة بقيمة $5، لكن القسائم لا تُحتسب ضمن الشحن التراكمي، ولم يُذكر ما إذا كانت تُطبَّق على K3.1 Pro [VERIFY]. ويبدأ حساب الـ $1 في المستوى Tier0 وفق صفحة الحدود: طلب متزامن واحد، و3 طلبات في الدقيقة، و1.5 مليون رمز يوميًا. أما Tier1 عند بلوغ $10 تراكميًا فيرفع ذلك إلى 100 طلب في الدقيقة.

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

هل Kimi K3.1 Pro مفتوح الأوزان؟

ليس بعد. تقول Moonshot إن أوزان النموذج الكاملة ستُصدر بحلول 4 نوفمبر 2026. ولم يُذكر الترخيص بعد.

ما الفرق بين K3.1 Pro وK3.1 Pro Highspeed؟

العائلة نفسها من النماذج، لكن السرعة والسعر مختلفان. يعمل Highspeed أسرع بمرتين إلى ثلاث مرات ويكلّف $4/$20 لكل مليون رمز مقابل $2/$10. وفي Kimi Code يحتاج إلى خطة Pro ويستهلك نحو ضعف الحصة.

هل يمكنني إيقاف التفكير في Kimi K3.1 Pro؟

لا. التفكير مُفعَّل دائمًا. اضبط reasoning_effort على "low" لتقليل رموز التفكير وزمن الاستجابة.

لماذا تنكسر محادثتي متعددة الأدوار؟

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

هل Kimi API مجاني؟

لا. يُفتح K3.1 Pro بعد شحن بحد أدنى $1. أما الدردشة المجانية على تطبيق Kimi فهي الخيار بتكلفة $0، وهو مشروح في دليلنا المجاني.

هل يدعم Kimi K3.1 Pro نافذة سياق بحجم 1M؟

نعم. تدعم واجهة API 1,048,576 رمزًا. وفي Kimi Code، يتطلب سياق الـ 1M الكامل خطة Allegretto (Pro) أو أعلى.