GPT-6.1 Sol are now live on CometAPI →
ai-model/أبحاث CometAPI

كيفية نشر Kimi K3 محليًا؟

请提供需要翻译成阿拉伯语的具体文本内容(可为纯文本、HTML/Markdown/JSON/XML/代码片段等)。我将严格保留原始结构与技术元素,仅翻译可读文本,不生成或改写新内容。

CometAPI
Deon Goodwinفريق أبحاث نماذج AI وAPI
تم التحديث Oct 1, 2026 18 دقائق للقراءة
كيفية نشر Kimi K3 محليًا؟
استخدم هذا النمط

أجرِ أول استدعاء لـ API.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

الخلاصة

Kimi K3 بوزن مفتوح وليس بمقياس محطة عمل: تشغيل النموذج الأصلي يتطلب وحدات GPU من فئة مراكز البيانات وذاكرة موزعة. استخدم vLLM لأقصر طريق إلى الإنتاج مباشرة، أو SGLang عندما تهمك الطوبولوجيا والتوازي بين الخبراء والتحكم في الذاكرة المؤقتة. تعمل إصدارات GGUF المجتمعية على خفض عتبة العتاد، لكنها ما تزال تتطلب نحو 500 GB إلى أكثر من 1 TB بكثير من الذاكرة القابلة للعنونة وتبادل السرعة أو الجودة مقابل إمكانية التشغيل. لأجهزة الكمبيوتر الشخصية وأجهزة Mac العادية، اختبر أولاً عبر واجهة API مستضافة ثم استضف ذاتيًا فقط عندما تبرر الخصوصية أو الاستفادة المستدامة أو التحكم في البنية التحتية التكلفة.

ما هو Kimi K3؟

Kimi K3 هو نموذج Moonshot AI الرائد متعدد الوسائط بوزن مفتوح، مصمم للعمل على الأمد الطويل في البرمجة، وأعمال المعرفة العاملية، والاستدلال، وفهم الرؤية.

تصفه Moonshot بأنه أول نموذج مفتوح من فئة 3T في العالم. تجمع بنيته بين Kimi Delta Attention وAttention Residuals وتصميم MoE متفرق يختار فقط مجموعة فرعية من الخبراء لكل رمز.

كيفية نشر Kimi K3 محليًا؟

الحجم غير اعتيادي حتى وفق معايير نماذج الطليعة. بدلاً من تفعيل كل معاملات 2.8T لكل رمز، ينتقي K3 16 من أصل 896 خبيرًا موجّهًا، بالإضافة إلى خبراء مشتركين. هذا يقلل الحساب لكل رمز بشكل كبير، مع أن جميع أوزان النموذج ما تزال بحاجة لأن تكون متاحة في مكان ما ضمن نظام الاستدلال.

المواصفاتKimi K3 — المواصفات الرسمية للنموذج
البنيةمزيج الخبراء (MoE)
إجمالي المعاملات2.8T
المعاملات المُفعّلة104B
عدد الخبراء896
الخبراء المختارون لكل رمز16
طول السياق1,048,576 رمزًا
مشفّر الرؤيةMoonViT-V2
التكميم الأصليMXFP4 weights / MXFP8 activations
أنماط بطاقة النموذج الرسميةنص + صورة

يطبق K3 أيضًا تدريبًا واعيًا بالتكميم بدءًا من مرحلة SFT بدل التعامل مع تقديم الدقة المنخفضة كخطوة ضغط بعد التدريب فقط.

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

كيف يؤدي Kimi K3؟

تضع مجموعة تقييمات Kimi K3 الرسمية من Moonshot المعلنة هنا النموذج قريبًا من نماذج الطليعة المغلقة الرائدة، خصوصًا في هندسة البرمجيات طويلة الأمد والأعمال العاملية.

يغطي الاختيار التالي الاستدلال والبرمجة والوكلاء والرؤية. الأعلى أفضل لجميع الدرجات المعروضة.

التقييم — نتائج Moonshot الرسميةKimi K3GPT-5.6 SolClaude Fable 5Claude Opus 4.8
GPQA Diamond93.594.192.691.0
ProgramBench77.877.676.871.9
Terminal-Bench 2.188.388.888.084.6
FrontierSWE81.271.386.666.7
SWE-Marathon42.039.035.040.0
BrowseComp91.290.488.084.3
OmniDocBench91.185.889.887.9
PerceptionBench58.559.757.247.2

تضع الدرجات الرسمية Kimi K3 بالقرب من GPT-5.6 Sol وClaude Fable 5 وClaude Opus 4.8 عبر مهام الاستدلال والبرمجة والوكلاء والرؤية. تعامل مع هذه النتائج المعلنة من المزود كإطار قدرات وليس ترتيبًا عالميًا؛ يتم تناول تحليل التقييم التفصيلي بشكل منفصل. نقطة التشغيل هنا هي أن الاستضافة الذاتية توفر قدرات من فئة الطليعة وتحكمًا في البنية التحتية، لكنها ليست اختصارًا منخفض التكلفة لسطح المكتب.

هل يمكنك فعليًا تشغيل Kimi K3 محليًا؟

نعم، لكن هناك تعريفين مختلفين جدًا لكلمة “محلي”.

  • خادم محلي / مركز بيانات خاص: واقعي.
  • سطح مكتب أو لابتوب عادي: ممكن تقنيًا بإصدارات مجتمعية مكثفة التكميم، لكنه غير عملي عمومًا للاستخدام التفاعلي.

يحدد إعداد vLLM الحالي لـ Kimi K3 خط أساس مرتفعًا جدًا:

  • NVIDIA: على الأقل 8× GB300
  • AMD ROCm: على الأقل 8× MI355X أو MI350X
  • تعريف NVIDIA: R580+ لصورة CUDA 13 الحالية الخاصة بـ K3
  • يُوصى بالبنية متعددة العقد لحركة الإنتاج الفعلية

كما عرض دليل vLLM في اليوم 0 مسار تشغيل سريع على 8 بطاقات B300 أو 8 بطاقات MI355X. لعملية نشر إنتاجية جديدة، اتبع الوصفة الأحدث لأنها تعكس حزمة الخدمة بعد تحسينات يوم الإطلاق.

هذه هي النقطة الأساسية: K3 بوزن مفتوح، لكنه ليس نموذجًا بمقياس المستهلك.

الأوزان الرسمية مقابل تكميم GGUF المجتمعي

هناك طريقة أخرى لخفض عتبة العتاد: التكميم المجتمعي.

يوفر مستودع Unsloth K3 الحالي عدة نسخ GGUF يمكن تشغيلها عبر برمجيات متوافقة مع llama.cpp.

مقارنة موحدة. أرقام الذاكرة القابلة للعنونة هي تقديرات تخطيطية (حجم التنزيل زائد نحو 10–15% هامش تشغيل) وليست ضمانات؛ قد تتطلب إعدادات السياق والذاكرة المؤقتة والرؤية والتفريغ المزيد.

المتغيرالتحميلالذاكرة القابلة للعنونة المقترحةدعم الرؤيةوقت التشغيل الموثّقالهدف / أدلة الجودة
UD-Q1_0466 GB≥520 GBيذكر المستودع دعم الرؤية؛ تحقق من مسار التشغيل المطابق.فرع PR لـ Unsloth على llama.cpp؛ مسار Ollama موثّق بإصدار غير مثبت.إثبات إمكانية؛ لا اختبار جودة مستقل خاص بالمتغير مذكور.
UD-TQ1_0509 GB≥570 GBنفس ملاحظة دعم الرؤية على مستوى المستودع.نفس مسار التشغيل الموثّق.تجربة فئة 1-بت عدوانية؛ لا اختبار جودة مستقل خاص بالمتغير مذكور.
UD-IQ1_S594 GB≥665 GBنفس ملاحظة دعم الرؤية على مستوى المستودع.نفس مسار التشغيل الموثّق.تجربة محلية قصوى؛ لا اختبار جودة مستقل خاص بالمتغير مذكور.
UD-IQ1_M649 GB≥730 GBنفس ملاحظة دعم الرؤية على مستوى المستودع.نفس مسار التشغيل الموثّق.تسوية 1-بت أعلى جودة؛ لا اختبار جودة مستقل خاص بالمتغير مذكور.
UD-IQ2_XXS711 GB≥800 GBنفس ملاحظة دعم الرؤية على مستوى المستودع.نفس مسار التشغيل الموثّق.تجربة فئة 2-بت؛ لا اختبار جودة مستقل خاص بالمتغير مذكور.
UD-Q2_K_XL861 GB≥970 GBنفس ملاحظة دعم الرؤية على مستوى المستودع.نفس مسار التشغيل الموثّق.خادم CPU/GPU كبير؛ لا اختبار جودة مستقل خاص بتكميم K3 مذكور.
UD-Q4_K_XL1.51 TB≥1.7 TBنفس ملاحظة دعم الرؤية على مستوى المستودع.أمثلة llama.cpp وOllama مباشرة موثّقة لهذا المتغير.تقديم GGUF يركز على الجودة؛ لا تقييم مستقل لتكميم K3 مذكور.
UD-Q8_K_XL1.56 TB≥1.75 TBنفس ملاحظة دعم الرؤية على مستوى المستودع.نفس مسار التشغيل الموثّق.بناء مجتمعي شبه عديم الفقد؛ فائدة تخزين قليلة مقارنة بـ Q4.

هذا التفريق يفسر أيضًا لماذا ذكرت بعض مقالات النشر المحلية المبكرة 594 GB: 594 GB تشير الآن إلى بناء UD-IQ1_S GGUF المجتمعي، وليس وصفًا مفيدًا لنقطة التحقق الأصلية الحالية الكاملة.

نموذج بحجم 466–649 GB أصغر بكثير من بصمة النشر الأصلية، لكنه ما يزال ضخمًا بمعايير محطات العمل. يجب أيضًا ترك ذاكرة لحالة وقت التشغيل والسياق والذاكرات المؤقتة ومسقِّط الرؤية وعمليات نظام التشغيل وغير ذلك من الحمل.

سعة القرص ليست مساوية لذاكرة الاستدلال. امتلاك SSD بسعة 1 TB لا يعني أن نموذج 600 GB سيعمل بسرعة على جهاز بذاكرة RAM سعة 64 GB. قد يجعل التفريغ إلى SSD التجارب القصوى ممكنة تقنيًا، لكن توليد الرموز قد يصبح بطيئًا للغاية.

كيفية نشر Kimi K3 باستخدام vLLM

للاستضافة الذاتية الجادة، يعد vLLM نقطة البداية الأكثر مباشرة.

تسرد Moonshot حاليًا vLLM كأحد محركات استدلال K3 الموصى بها، كما يقدم vLLM دعمًا خاصًا لـ KDA وMXFP4 MoE وتحليل الاستدلال واستدعاء الأدوات وتخزين البوادئ المؤقت والتوزيع.

تحقق من المتطلبات الأساسية

للنشر الإنتاجي على NVIDIA، تستخدم الوصفة المختبرة الحالية الحاوية vllm/vllm-openai:kimi-k3.

تحقق من وحدات GPU:

nvidia-smi

تأكد من Docker:

docker --version

تأكد من أن NVIDIA Container Toolkit يرى المسرّعات:

docker run --rm --gpus all nvidia/cuda:13.0.0-base-ubuntu24.04 nvidia-smi

إذا لم يستطع الأمر الأخير رؤية جميع وحدات GPU، أصلح بيئة تشغيل GPU على المضيف/الحاوية قبل تنزيل نموذج متعدد التيرابايت.

عيّن رمز Hugging Face

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

export HF_TOKEN="YOUR_HUGGING_FACE_TOKEN"

اسحب حاوية vLLM الخاصة بـ K3

docker pull vllm/vllm-openai:kimi-k3

تحدد الوصفة الحالية بناء CUDA 13 وتعريف NVIDIA بإصدار R580 أو أحدث.

تشغيل Kimi K3

قالب بدء تشغيل Blackwell TP8 الحالي (وصفة vLLM محدّثة في 2026-09-10): استخدمه كخط أساس، ثم أعد التوليد أو اختبر الأداء لعتادك وحركة المرور لديك بالضبط.

docker run --rm \
  --gpus all \
  --ipc=host \
  -p 8000:8000 \
  -v ~/.cache/huggingface:/root/.cache/huggingface \
  -e HF_TOKEN="$HF_TOKEN" \
  -e VLLM_USE_V2_MODEL_RUNNER=1 \
  vllm/vllm-openai:kimi-k3 \
  --model moonshotai/Kimi-K3 \
  --tensor-parallel-size 8 \
  --gpu-memory-utilization 0.95 \
  --kv-cache-dtype fp8 \
  --attention-backend TOKENSPEED_MLA \
  --attention-config '{"use_prefill_query_quantization":true,"mla_prefill_backend":"TOKENSPEED_MLA"}' \
  --prefix-match-unit 128 \
  --enable-prefix-caching \
  --max-model-len 131072 \
  --enable-auto-tool-choice \
  --tool-call-parser kimi_k3 \
  --reasoning-parser kimi_k3

تتطلب الوصفة الحالية صورة K3 لـ CUDA 13 وتعريف NVIDIA بإصدار R580 أو أحدث. يجب إقران ذاكرة KV المؤقتة بدقة FP8 مع خلفية MLA متوافقة للتهيئة/الفك؛ اختبر بدائل الانتباه قبل تغيير الإعداد.

المصدر: وصفة vLLM لـ Kimi K3. هذا يستبدل أمر اليوم 0 السابق بدل تقديمه كالوصفة الإنتاجية الحالية.

لأول تشغيل تحقق، فكّر في تقليل الحد الأقصى لطول النموذج بدلًا من تخصيص القدرة كاملة البالغة 1,048,576 رمزًا فورًا. توصي وصفة vLLM الحالية صراحةً بضبط max-model-len وفق عبء العمل.

على سبيل المثال:

--max-model-len 131072

هذا لا يغيّر حد السياق المعماري لـ K3. إنه فقط يمنح محرك الخدمة نطاق تشغيل أكثر قابلية للإدارة لاختباراتك الأولية.

اختبار نقطة النهاية المحلية

يعرض vLLM واجهة API متوافقة مع OpenAI على المنفذ 8000.

curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/Kimi-K3",
    "messages": [
      {
        "role": "user",
        "content": "Explain the difference between tensor parallelism and expert parallelism."
      }
    ],
    "max_tokens": 512
  }' 

أو استخدم OpenAI Python SDK:

python

from openai import OpenAI

 client = OpenAI(
    base_url="http://localhost:8000/v1",
    api_key="EMPTY",
    timeout=3600,
 )

response = client.chat.completions.create(
    model="moonshotai/Kimi-K3",
    messages=[
        {
            "role": "user",
            "content": "Write a Python function that validates a JSON schema.",
        }
    ],
    max_tokens=1024,
 )

print(response.choices[0].message.content)

تستخدم الوصفة الرسمية لـ vLLM نفس نمط localhost المتوافق مع OpenAI، ما يجعل تبديل التطبيق بين الاستدلال المحلي والمستضاف أمرًا سهلًا نسبيًا.

كيفية نشر Kimi K3 باستخدام SGLang

SGLang هو المسار الآخر الرئيسي للنشر الذي توصي به Moonshot رسميًا.

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

استخدم كتاب الطهي المخصص لـ SGLang الخاص بـ Kimi K3 واختر طوبولوجيا خاصة بالعتاد. التالي هو ملف تعريف Unified/Balanced مؤكد لعقدة واحدة 8×B300 من كتاب الطهي؛ تم قياسه باستخدام SGLang v0.5.18 على الالتزام 71de97b2.

ثبّت بناءً يدعم K3:

pip install --upgrade pip
pip install uv
uv pip install --prerelease=allow sglang

شغّل ملف تعريف B300 TP8/DCP8 المؤكّد:

sglang serve \
  --trust-remote-code \
  --model-path moonshotai/Kimi-K3 \
  --tp-size 8 \
  --dcp-size 8 \
  --mem-fraction-static 0.85 \
  --mamba-full-memory-ratio <value-from-official-calculator> \
  --reasoning-parser kimi_k3 \
  --tool-call-parser kimi_k3 \
  --host 0.0.0.0 \
  --port 30000

تتعلق قيمة --mamba-full-memory-ratio بعبء العمل: احسبها من متوسط طول الإدخال زائد الإخراج في كتاب الطهي الرسمي. لا تنسخ هذه الطوبولوجيا الخاصة بـ B300 إلى H100/H200 أو GB200/GB300 أو AMD أو عمليات نشر متعددة العقد؛ تستخدم تلك ملفات TP/PP/DCP/EP مختلفة.

اختبر الخادم:

curl http://localhost:30000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/Kimi-K3",
    "messages": [{"role": "user", "content": "Give me a five-step debugging plan for a distributed Python application."}]
  }'

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

vLLM مقابل SGLang مقابل llama.cpp

يعتمد اختيار محرك الاستدلال أساسًا على عتادك وهدف النشر.

طريقة النشرفئة العتادالأوزان الأصلية الرسميةواجهة API متوافقة مع OpenAIإنتاج موزعسهولة الإعدادأفضل ملاءمة
vLLMعنقود GPU لفئة مراكز البياناتنعمنعمممتازمتوسطةخيار الإنتاج الافتراضي
SGLangعنقود GPU لفئة مراكز البياناتنعمنعمممتازمتوسطة–عاليةخدمة موزعة متقدمة
llama.cpp + GGUFمحطة عمل/خادم بذاكرة ضخمةتكميم مجتمعينعممحدود مقارنة بـ vLLM/SGLangمنخفضة–متوسطةتجارب محلية
Ollama + GGUFمحطة عمل/خادم بذاكرة ضخمةتكميم مجتمعينعمليس الهدف الأساسيسهلةاختبار يفضل السهولة
CometAPIلا تتطلب GPU محليًامستضافةنعممُدارةسهلة جدًامطورون بلا عتاد من فئة K3

إذا كنت تملك خادمًا بـ 8 وحدات GPU من فئة Blackwell/MI35x، فابدأ مع vLLM.

إذا كنت تصمم عنقود استدلال موزعًا متخصصًا وتريد مزيدًا من تحكم الخدمة منخفض المستوى، فقَيِّم SGLang أيضًا.assistant_message

إذا كان هدفك ببساطة “أريد إثبات أن K3 يمكنه التنفيذ على العتاد الذي أملكه”، فإن GGUF مع llama.cpp أكثر قابلية—بشرط أن تمتلك جهازًا بذاكرة استثنائية حقًا.

كيفية تشغيل Kimi K3 مُكمّمًا باستخدام llama.cpp أو Ollama

يوفر مستودع Kimi K3 GGUF المجتمعي الآن نسخًا متوافقة مع llama.cpp.

يخفض هذا المسار حاجز الدخول بشكل كبير مقارنة بنشر الأوزان الأصلية لفئة مراكز البيانات، لكن “بشكل كبير” أمر نسبي: حتى الإصدارات الأصغر هي بمئات الجيجابايت.

تثبيت llama.cpp على macOS أو Linux

يوفر كرت النموذج GGUF الحالي:

curl -LsSf https://llama.app/install.sh | sh

على Windows:

winget install llama.cpp

بدء خادم متوافق مع OpenAI

يوثق المستودع حاليًا UD-Q4_K_XL كمثال:

llama serve \
  -hf unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

يمكنك أيضًا تشغيل CLI مباشرة:

llama cli \
  -hf unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

تأتي هذه الأوامر مباشرة من كرت نموذج Kimi K3 GGUF الحالي.

إلا أن UD-Q4_K_XL يبلغ نحو 1.51 TB، لذا ليس المتغير الذي سيبدأ به معظم مستخدمي محطات العمل. إذا كانت أولويتك تقليل متطلبات الذاكرة بدل الحفاظ على أكبر قدر ممكن من الجودة، فافحص أولًا متغيرات 1-بت و2-بت الأصغر.

على سبيل المثال:

llama serve \
  -hf unsloth/Kimi-K3-GGUF:UD-IQ1_M

يبلغ دليل UD-IQ1_M الحالي تقريبًا 649 GB.

ما يزال نموذج 649 GB بعيدًا عن كونه نموذجًا للابتوب العادي. من المثالي أن تقيم حالة النموذج كثير الاستخدام في ذاكرة سريعة. قد يجعل التفريغ الكثيف إلى SSD التجربة القصوى ممكنة تقنيًا دون جعلها مفيدة للعمل التفاعلي.

تشغيل نفس بناء GGUF بواسطة Ollama

Ollama هو طبقة راحة لمسار النشر نفسه عبر GGUF، وليس طريقة استضافة ذاتية رابعة مستقلة.

يعرض مستودع K3 GGUF أيضًا مسار Ollama.

على سبيل المثال:

bash

ollama run hf.co/unsloth/Kimi-K3-GGUF:UD-Q4_K_XL

يبسط Ollama إدارة النماذج وتجربة واجهة API، لكنه لا يغيّر متطلبات الذاكرة الخاصة بـ K3.

تغيير المُشغّل من llama.cpp إلى Ollama لا يمكنه تحويل تكميم بحجم عدة مئات الجيجابايت إلى نموذج GPU بسعة 24 GB. لا بد من تخزين بيانات النموذج الأساسية والوصول إليها.

لهذا السبب، من الأفضل النظر إلى Ollama على أنه غلاف تشغيل مريح، وليس حلاً لتجاوز العتاد.

ما أفضل تكميم Kimi K3 الذي ينبغي اختياره؟

للتجارب، يكون الاختيار في الأساس مقايضة بين حجم النموذج والوفاء.

خيارات تكميم GGUFالحجمضغط الذاكرة النسبيتوقع الجودةالاستخدام الموصى به
UD-Q1_0466 GBالأدنىمخاطر تدهور أعلىإثبات إمكانية
UD-IQ1_S594 GBعالٍ جدًاعدوانيتجارب محلية قصوى
UD-IQ1_M649 GBعالٍ جدًاتسوية 1-بت أفضلخادم تجريبي بذاكرة كبيرة
UD-Q2_K_XL861 GBبالغ الشدةوفاء أفضلخادم CPU/GPU كبير
UD-Q4_K_XL1.51 TBفئة مراكز البياناتوفاء أعلىاستضافة ذاتية تركز على الجودة
تقديم K3 الأصليفئة مراكز البياناتفئة مراكز البياناتسلوك النموذج المقصودالإنتاج

سلوك مهم في تقديم Kimi K3

هناك تفصيلة تنفيذ خاصة بـ K3 يسهل تجاهلها.

يستخدم K3 سجل تفكير محفوظ. تقول Moonshot إن المحادثات متعددة الأدوار وتدفقات استدعاء الأدوات يجب أن تُعيد إرسال رسالة المساعد السابقة كاملةً إلى النموذج، بما في ذلك reasoning_content وtool_calls، بدلًا من الاحتفاظ بالمحتوى المرئي فقط.

نمط تطبيق مبسط يبدو كالتالي:

messages = [
    {
        "role": "user",
        "content": "Inspect this project and propose a migration plan.",
    }
 ]

first = client.chat.completions.create(
    model="moonshotai/Kimi-K3",
    messages=messages,
    max_tokens=2048,
 )

assistant_message = first.choices[0].message

 # Preserve the whole message object, not just assistant_message.content.
 messages.append(
    assistant_message.model_dump(exclude_none=True)
 )

messages.append(
    {
        "role": "user",
        "content": "Now identify the riskiest part of that plan.",
    }
 )

second = client.chat.completions.create(
    model="moonshotai/Kimi-K3",
    messages=messages,
    max_tokens=2048,
 )

يصبح هذا مهمًا بشكل خاص لوكلاء البرمجة وحلقات الأدوات والجلسات المستقلة طويلة التشغيل.

يبقي K3 الاستدلال مُمكّنًا ويدعم جهد استدلال منخفض وعالٍ وأقصى. عندما تعرض طبقة الخدمة تلك المعلمات، تعامل مع جهد الاستدلال كعنصر للتحكم في زمن الاستجابة/الجودة بدل تعظيمه دائمًا لكل طلب.

كيفية تحسين نشر Kimi K3 محليًا

لا تخصّص سياق 1M كاملًا فورًا

يدعم K3 1,048,576 رمزًا، لكن الحد الأقصى لقدرة النموذج والتكوين المعقول للخادم شيئان مختلفان.

للتطوير، ابدأ مثلًا بـ:

--max-model-len 131072

ثم زد السياق فقط بعد قياس الذاكرة المتاحة، وزمن الوصول إلى أول رمز، والمعدل، والتوازي المتوقع.

فعّل تخزين البوادئ المؤقت

تعيد وكلاء البرمجة استخدام تعليمات المستودع ومخططات الأدوات ومطالبات النظام والبوادئ الطويلة بشكل متكرر.

مع vLLM:

--enable-prefix-caching

تطلبت بنية الانتباه الهجينة لـ K3 معالجة خاصة لتخزين البوادئ المؤقت، وقد نفّذ vLLM دعمًا خاصًا للنموذج لذلك.

استخدم محلّلات K3

لأعباء عمل الوكلاء، أدرج:

--tool-call-parser kimi_k3 \
--reasoning-parser kimi_k3

هذا يُبقي استدعاءات الأدوات ومخرجات الاستدلال متوافقة مع صيغة تقديم K3.

حافظ على تخزين سريع

يضع نموذج بهذا الحجم ضغطًا غير اعتيادي على التخزين المحلي أثناء أول تنزيل، وتحميل نقاط التحقق، والتحديثات، والاسترداد.

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

راقب أكثر من استخدام GPU

تتبّع:

  • استخدام HBM/VRAM
  • RAM على CPU
  • معدل ضرب الذاكرة المؤقتة
  • زمن الوصول إلى أول رمز
  • معدل فك الترميز (رموز/ثانية)
  • عمق صف الطلبات
  • الاتصال بين وحدات GPU
  • عرض النطاق بين العقد
  • فشل تحليل استدعاء الأدوات
  • زمن تحميل النموذج

على مقياس K3، لا يخبرك رقم استخدام GPU الظاهري الصحي ما إذا كانت طوبولوجيا الخدمة فعالة.

Kimi K3 محليًا مقابل Kimi K3 مستضافًا

تمنح الاستضافة الذاتية الفرق أقصى تحكم في مسار البيانات ووقت التشغيل وأوزان النموذج، بينما تجعلهم مسؤولين أيضًا عن سعة GPU، والتوسعة، والترقيات، والمراقبة، والاسترداد. الوصول المستضاف يُزيل معظم عمل البنية التحتية ويكون عمومًا المسار الأسرع للتقييم أو الطلب المتغير.

للحصول على التحليل الكامل للعتاد ونقطة التعادل، اقرأ Kimi K3 Self-Hosting vs API. لأسعار الرموز والتخزين المؤقت ومقارنات K2.7، استخدم دليل تسعير Kimi K3. لذلك يُبقي هذا المقال المقارنة موجزة ويركز على أوامر النشر والتكوين واستكشاف الأخطاء.

مشكلات شائعة في النشر المحلي لـ Kimi K3

النموذج لا يتسع في ذاكرة GPU

هذا هو الفشل الأكثر توقعًا.

لا تحسب الذاكرة بناءً على 104B من المعاملات المُفعّلة. يصف هذا الرقم الحساب لكل رمز، وليس مقدار بيانات وزن الخبراء الذي يجب أن توفره منظومة الخدمة.

استخدم طوبولوجيا موزعة مدعومة، أو تكميم GGUF أصغر، أو خدمة مستضافة.

أخطاء CUDA أو تعريف NVIDIA

تعتمد صورة vLLM K3 الحالية على CUDA 13 وتتطلب تعريف مضيف R580+.

إذا كان المضيف ما يزال على مكدس R575/CUDA 12.9، فقم بتحديثه أو اتبع مسار البناء من المصدر الذي وصفه vLLM بدل افتراض أن الحاوية ستُصلح عدم توافق تعريف المضيف.

الطلب الأول بطيء للغاية

تحقق مما إذا كانت نقطة التحقق ما تزال تُحمّل، أو تُجمّع الأنوية، أو تُسخّن الذاكرات المؤقتة، أو تسحب الملفات.

مع أصول من فئة التيرابايت المتعددة، “تم بدء عملية الخادم” و“النموذج جاهز لحركة إنتاجية” ليستا حالتين متكافئتين.

فشل استدعاءات الأدوات بشكل متقطع

تشير وصفة vLLM الحالية إلى أن K3 قد يُنتج أحيانًا صيغة لاستدعاء أداة لا يتوقعها محلله. لذا يجب على أنظمة الإنتاج التحقق من صحة مخططات استدعاء الأدوات وتنفيذ إعادة المحاولة بدل الثقة العمياء بكل استدعاء مُولّد.

تصبح المحادثات الطويلة أقل استقرارًا

تأكد من أنك تُعيد الرسالة الكاملة للمساعد—بما في ذلك معلومات الاستدلال والأدوات—إلى أدوار K3 التالية.

قد يُعطل إسقاط الحقول المخفية لحالة الاستدلال نمط سجل التفكير المحفوظ الذي تم تدريب K3 عليه.

إذًا، ما أفضل طريقة لنشر Kimi K3 محليًا؟

بالنسبة لمعظم المؤسسات التي تمتلك العتاد المناسب، vLLM هو أفضل مسار نشر أول. لديه دعم مخصص لـ K3، وواجهة API متوافقة مع OpenAI، ومحللات خاصة بالنموذج، وتخزين مسبق للبوادئ، ودعم فك تكهّنّي، ووصفات عتاد حديثة.

اختر SGLang عندما تكون هندسة الاستدلال الموزع والتحكم الدقيق في الخدمة أكثر أهمية من أقصر مسار إعداد.

اختر llama.cpp مع تكميم GGUF مجتمعي فقط عندما يكون هدفك هو تجارب محطة عمل/خادم وتفهم أن حتى نسخ 1-بت تبقى بمئات الجيجابايت.

لجهاز مطور تقليدي، الاستنتاج الأكثر عملية مختلف: لا تشترِ مئات الجيجابايت من RAM فقط لإجبار K3 على سطح مكتب. اختبر Kimi K3 عبر CometAPI أولًا، وكمّن فوائده على مهامك الخاصة، وانتقل إلى الاستضافة الذاتية فقط عندما تجعل الخصوصية أو الاستفادة المستدامة أو التحكم بالبنية التحتية الاقتصاديات مجدية.

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

هل يمكن تشغيل Kimi K3 على وحدة GPU استهلاكية واحدة؟

ليس واقعيًا. النموذج أبعد بكثير من سعة VRAM لوحدات GPU الاستهلاكية. تقلّل تكميمات GGUF ذات البِتّات المنخفضة المجتمعية البصمة بشكل كبير، لكن أصغر المتغيرات الحالية ما تزال بمئات الجيجابايت.

هل يمكنني تشغيل Kimi K3 على Mac؟

تنفيذ تجريبي على CPU/Apple Silicon مع GGUF والتفريغ إلى التخزين ممكن من حيث المبدأ، لكن الأداء التفاعلي وسعة الذاكرة هما عاملا القيد. لا ينبغي التعامل مع MacBook نموذجي كمنصة تقديم عملية لـ K3.

هل يدعم Kimi K3 برنامج Ollama؟

يمكن تشغيل إصدارات GGUF المجتمعية عبر Ollama. يُبسط وقت التشغيل الإعداد لكنه لا يغيّر متطلبات الذاكرة الأساسية.

أيهما أفضل لـ Kimi K3: vLLM أم SGLang؟

vLLM أسهل افتراضيًا لنشر إنتاجي جديد. SGLang جذّاب للفرق التي تبني طوبولوجيات خدمة موزعة متطورة. كلاهما من محركات الاستدلال الموصى بها لـ K3 من Moonshot.

كم يبلغ سياق Kimi K3؟

يدعم التحديد الرسمي للنموذج 1,048,576 رمزًا. خادم محلي لا يجب أن يكشف كامل نافذة السياق؛ قد يكون تعيين max-model-len أدنى أكثر عملية للنشر المبكر والتوازي الأعلى.

هل Kimi K3 مفتوح المصدر؟

الوصف الأدق هو “بوزن مفتوح”. أصدرت Moonshot أوزان النموذج بموجب ترخيص Kimi K3. راجع هذا الترخيص مباشرة قبل إعادة التوزيع التجاري أو أي استخدام يهمه شروط الترخيص.

ما أسهل طريقة لاستخدام Kimi K3 دون وحدات GPU محلية؟

واجهة API مستضافة هي أبسط طريق. Kimi K3 متاح عبر CometAPI بواجهة دردشة متوافقة مع OpenAI، لذا يمكن أن يبقى كود التطبيق قريبًا مما ستستخدمه ضد خادم vLLM أو SGLang محلي.

تابع التعلّم

اربط هذه المقالة بالقرار التالي.

عرض جميع الموضوعات
نُشر في Oct 1, 2026
آخر تحديث Oct 1, 2026
2 مشاهدات
تمت المراجعة للوضوح ودقة المصدر ومصطلحات API الحالية.

اقرأ المزيد