كيف تستخدم API كود كيمي K2.7

تمنحك واجهة برمجة تطبيقات Kimi K2.7 Code نموذج Moonshot الذي يضم تريليون معلمة والمُحسّن للترميز، عبر نقطة نهاية متوافقة مع OpenAI. إذا كان بإمكانك استدعاء واجهة برمجة تطبيقات OpenAI، فيمكنك استدعاء هذه الواجهة؛ فقط قم بتبديل عنوان URL الأساسي، وتعيين معرف النموذج، وستكون قد انتهيت. توجد أيضًا نقطة نهاية متوافقة مع Anthropic بحيث تندمج مباشرة في Claude Code.

يشمل هذا الدليل كلا الطريقتين للوصول إليها، وعنوان URL الأساسي الدقيق ومعرفات النموذج، وكود عملي في curl و Python و Node، والأسعار، وكيفية اختبار الأمر برمته في Apidog قبل إطلاقه.

زر

باختصار

عنوان URL الأساسي: https://api.moonshot.ai/v1 (متوافق مع OpenAI). بالنسبة لـ Claude Code، استخدم https://api.moonshot.ai/anthropic.
معرف النموذج: kimi-k2.7-code على واجهة برمجة تطبيقات Moonshot المدفوعة حسب الرمز؛ kimi-for-coding عند الاشتراك في Kimi Code.
الأسعار: 0.95 دولار لكل مليون رمز إدخال، 4.00 دولارات لكل مليون رمز إخراج، 0.19 دولار لكل مليون عند استخدام ذاكرة التخزين المؤقت.
احصل على مفتاح من لوحة تحكم منصة Kimi، ثم استدعه كأي نقطة نهاية لـ OpenAI.
يُجري النموذج دائمًا عملية التفكير (التفكير إجباري)، لذا توقع رموز التفكير في كل استجابة.

طريقتان للوصول إلى النموذج

اختر المسار الذي يتناسب مع كيفية استخدامك له.

واجهة برمجة تطبيقات المطور المدفوعة حسب الرمز. فواتير الاستخدام القياسية عبر واجهة برمجة تطبيقات Moonshot. معرف النموذج kimi-k2.7-code، عنوان URL الأساسي https://api.moonshot.ai/v1. هذا ما تحتاجه لحركة المرور الإنتاجية، والسكربتات، وأي شيء برمجي.

اشتراك Kimi Code. خطة بسعر ثابت مرتبطة بـ Kimi Code CLI واللوحة. تستخدم المفاتيح من لوحة تحكم Kimi Code معرف النموذج kimi-for-coding ويتم خصمها من حصة تتجدد كل 7 أيام بدلاً من كل رمز. أفضل للترميز التفاعلي المكثف، حيث قد تتراكم تكاليف الرموز.

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

الخطوة 1: الحصول على مفتاح API

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

export MOONSHOT_API_KEY="sk-your-key-here"

تعامل مع المفتاح ككلمة مرور. لا تلتزم به، ولا تلصقه في كود من جانب العميل.

الخطوة 2: إجراء طلبك الأول

تُطابق نقطة النهاية عمليات إكمال الدردشة الخاصة بـ OpenAI، لذا يعمل استدعاء curl البسيط:

curl https://api.moonshot.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.7-code",
    "messages": [
      {"role": "system", "content": "You are a careful senior engineer."},
      {"role": "user", "content": "Write a Python function that validates an email and returns a clear error message."}
    ]
  }'

ستتلقى استجابة قياسية على شكل OpenAI: مصفوفة choices تحتوي على الرسالة، بالإضافة إلى كائن usage يوضح عدد رموز الإدخال والإخراج والتفكير.

الخطوة 3: استدعاؤه من Python

نظرًا لأنه متوافق مع OpenAI، فإن SDK الرسمي openai يعمل مع تغيير عنوان URL الأساسي:

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

resp = client.chat.completions.create(
    model="kimi-k2.7-code",
    messages=[
        {"role": "user", "content": "Refactor this loop for readability and explain why."},
    ],
)

print(resp.choices[0].message.content)
print(resp.usage)

لا يوجد عميل جديد، ولا طبقة HTTP مخصصة. نفس الكود الذي يتحدث إلى GPT يتحدث الآن إلى Kimi.

الخطوة 4: استدعاؤه من Node

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MOONSHOT_API_KEY,
  baseURL: "https://api.moonshot.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "kimi-k2.7-code",
  messages: [
    { role: "user", content: "Write a Jest test for an empty-input edge case." },
  ],
});

console.log(resp.choices[0].message.content);

ما يجب معرفته عن سلوك النموذج

بعض الخصائص الغريبة تشكل كيفية استدعائه.

التفكير دائمًا قيد التشغيل. K2.7 Code يفرض التفكير ويحتفظ به عبر الأدوار. كل استجابة تحمل رموز تفكير، والتي تدفع ثمنها كإخراج. الجانب الإيجابي هو أنه يفكر بكفاءة أكبر بنسبة 30٪ تقريبًا من K2.6، لذا الفاتورة أخف من الجيل السابق لنفس العمل.

استدعاء الأداة يعمل بطريقة OpenAI. قم بتمرير مصفوفة tools مع مخططات الوظائف ويعيد النموذج كائنات استدعاء الأداة التي تقوم بتنفيذها وتغذيتها مرة أخرى. إنه مُحسّن للاستخدام المتعدد الخطوات للأدوات، لذا فهو يتعامل مع السلاسل الطويلة دون أن يفقد المسار.

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

الأسعار وحدود المعدل

الأسعار المدفوعة حسب الرمز:

نوع الرمز	السعر لكل مليون
الإدخال	$0.95
الإخراج (بما في ذلك التفكير)	$4.00
الاستخدام من ذاكرة التخزين المؤقت	$0.19

هناك عاملان يبقيان التكاليف منخفضة. يتم تحصيل رسوم استخدام ذاكرة التخزين المؤقت بجزء صغير من سعر الإدخال، لذا تصبح مطالبات النظام المتكررة والسياق المشترك رخيصة. كما أن ميزانية التفكير المخفضة تعني عددًا أقل من رموز الإخراج لكل مهمة مقارنة بـ K2.6. لمزيد من التكتيكات، راجع دليلنا حول تقليل تكاليف رموز العميل. إذا كنت تريد أرقام الجيل الأقدم للمقارنة، فإن دليل Kimi K2.6 API و دليل DeepSeek V4 API يغطيان ذلك.

استخدمه داخل Claude Code، Cline، أو Cursor

لا يتعين عليك كتابة عميل لتشغيل K2.7 Code في محرر الأكواد الخاص بك.

Claude Code. وجهه إلى نقطة النهاية المتوافقة مع Anthropic:

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k2.7-code"

Cline و RooCode. حدد Moonshot كمزود، اختر نقطة النهاية api.moonshot.ai، الصق مفتاحك، واختر kimi-k2.7-code كنموذج. قم بتعطيل أداة المتصفح لضمان التشغيل الأكثر سلاسة.

Cursor. أضف النموذج من خلال نقطة نهاية مخصصة متوافقة مع OpenAI بنفس عنوان URL الأساسي والمفتاح. الإعداد يعكس دليل تكامل Kimi-in-Cursor؛ يتغير معرف النموذج فقط.

اختبار وتصحيح أخطاء API في Apidog

قبل ربط واجهة برمجة التطبيقات (API) بعميل، تأكد بالضبط مما تعيده. يمنحك Apidog مساحة عمل مرئية لإرسال الطلبات وفحص الاستجابات وتثبيت الاختبارات.

أنشئ طلب POST إلى https://api.moonshot.ai/v1/chat/completions.
أضف الرأس Authorization: Bearer {{MOONSHOT_API_KEY}}، مع تخزين المفتاح كمتغير بيئة في Apidog حتى لا يكون نصًا عاديًا أبدًا.
أرسل نصًا على نمط OpenAI مع "model": "kimi-k2.7-code" ورسائلك (messages).
قم بتشغيله. يقوم Apidog بتنسيق JSON، ويُظهر عدد رموز usage، ويحفظ الاستدعاء.
حوّل الاستدعاء إلى اختبار: تحقق من أن الحالة هي 200، وأن choices[0].message.content ليس فارغًا، وأن usage.completion_tokens يبقى أقل من الميزانية التي تحددها.

الآن لديك اختبار انحدار يمكنك إعادة تشغيله مع كل تحديث للنموذج. إذا كنت تمارس استدعاءات الأدوات الخاصة بالنموذج من خلال MCP، فإن دليل اختبار خادم MCP الخاص بنا يوضح التأكيدات التي تكتشف عقود الأدوات المعطلة. قم بتنزيل Apidog لإعداده.

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

ما هو عنوان URL الأساسي لواجهة برمجة التطبيقات (API)؟ https://api.moonshot.ai/v1 للمكالمات المتوافقة مع OpenAI، و https://api.moonshot.ai/anthropic لـ Claude Code.

ما هو معرف النموذج الذي أستخدمه؟ kimi-k2.7-code على واجهة برمجة تطبيقات الدفع حسب الرمز. يستخدم اشتراك Kimi Code kimi-for-coding.

هل هو متوافق مع OpenAI؟ نعم. يتطابق تنسيق الطلب والاستجابة مع إكمال الدردشة في OpenAI، لذا تعمل حزم SDK الحالية مع تغيير عنوان URL الأساسي. توجد أيضًا نقطة نهاية متوافقة مع Anthropic.

كم تكلفته؟ 0.95 دولار لكل مليون رمز إدخال، 4.00 دولارات لكل مليون رمز إخراج، و 0.19 دولار لكل مليون عند استخدام ذاكرة التخزين المؤقت.

هل أدفع دائمًا مقابل رموز التفكير؟ نعم. يتم فرض التفكير، لذا تتضمن كل استجابة رموز تفكير تُحسب بسعر الإخراج. لا يزال يستخدم حوالي 30٪ أقل من K2.6.

هل يمكنني إرسال صور؟ نعم. النموذج متعدد الوسائط، لذا يتم دعم محتوى الصور في مصفوفة الرسائل.

الملخص

تُعد واجهة برمجة تطبيقات Kimi K2.7 Code على بُعد تغيير عنوان URL الأساسي من أي عميل متوافق مع OpenAI: استخدم https://api.moonshot.ai/v1، واستخدم معرف النموذج kimi-k2.7-code، وادفع 0.95 دولار / 4.00 دولارات لكل مليون رمز. للترميز التفاعلي، قد يكون اشتراك Kimi Code بسعر ثابت مع kimi-for-coding أقل تكلفة. يمكن توصيله بـ Claude Code و Cline و RooCode و Cursor بتغيير في الإعدادات، ويمكنك التحقق من كل شيء في Apidog قبل الوثوق به في الإنتاج. احصل على مفتاح، وأرسل استدعاء curl أعلاه، وتحقق من استخدام الرموز لترى كيف تتناسب الأسعار مع عبء عملك.

زر