بدء استخدام Kimi K2.7 Code API على Novita AI

بدء استخدام Kimi K2.7 Code API على Novita AI

Kimi K2.7 Code متاح على Novita AI بمعرف النموذج moonshotai/kimi-k2.7-code، ونقطة نهاية chat/completions متوافقة مع OpenAI، ونافذة سياق بسعة 262,144 رمزًا، ودعم لإدخال النصوص والصور والفيديو. يغطي هذا الدليل السريع الإعداد للمطورين: المصادقة، إرسال طلبك الأول، استخدام إدخال الصور، إضافة استدعاء الدوال، وفهم التسعير قبل البدء في البناء. للحصول على نظرة أوسع حول التموضع وحالات الاستخدام، راجع نظرة عامة على Kimi K2.7 Code على Novita AI.

إعداد Kimi K2.7 Code API

ابدأ بثلاثة عناصر تكوين:

العنصر القيمة
مفتاح API قم بإنشاء وتخزين مفتاح API لـ Novita AI في متغير بيئة مثل NOVITA_API_KEY.
عنوان URL الأساسي المتوافق مع OpenAI https://api.novita.ai/openai
نقطة نهاية إكمال الدردشة POST https://api.novita.ai/openai/v1/chat/completions
معرف النموذج moonshotai/kimi-k2.7-code

فهرس وثائق Novita AI يسرد عنوان URL الأساسي المتوافق مع OpenAI، ومرجع واجهة برمجة تطبيقات إكمال الدردشة يوثق حقول الطلب والاستجابة الكاملة.

احتفظ بمفتاح API خارج نظام التحكم في المصدر. قم بتصديره في شل الخاصة بك للتطوير المحلي:

export NOVITA_API_KEY="your_api_key"

إذا كان تطبيقك يستخدم بالفعل OpenAI SDK، فإن التغيير ضئيل: قم بتوجيه عنوان URL الأساسي إلى Novita AI واضبط النموذج على moonshotai/kimi-k2.7-code.

تسعير وحدود Kimi K2.7 Code

استخدم معرف النموذج الدقيق في الكود. في واجهة المستخدم المواجهة للمستخدم، استخدم اسم العرض “Kimi K2.7 Code”.

الحقل القيمة الحالية لـ Novita
اسم العرض Kimi K2.7 Code
معرف نموذج API moonshotai/kimi-k2.7-code
سلسلة النماذج MoonshotAI
البنية المعمارية MoE، 1T معلمة إجمالاً، 32B مفعلة
عائلات نقاط النهاية chat/completions، anthropic
طرق الإدخال نص، صورة، فيديو
طريقة الإخراج نص
نافذة السياق 262,144 رمزًا
الحد الأقصى لرموز الإخراج 262,144 رمزًا
الميزات استدعاء الدوال، المخرجات المنظمة، التفكير

اعتبارًا من 16 يونيو 2026، تسرد Novita أسعار الرموز هذه لـ moonshotai/kimi-k2.7-code:

نوع الرمز السعر المدرج
رموز الإدخال 0.95 دولار لكل مليون رمز
رموز الإخراج 4.00 دولارات لكل مليون رمز
رموز إدخال قراءة ذاكرة التخزين المؤقت 0.19 دولار لكل مليون رمز

يمكن أن تتغير الأسعار والتوفر وحدود المعدل. تحقق من صفحة نموذج Kimi K2.7 Code و صفحة تسعير Novita AI قبل الإطلاق الإنتاجي أو أي التزام مالي.

مثال على استخدام Kimi K2.7 Code مع cURL

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

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -d '{
    "model": "moonshotai/kimi-k2.7-code",
    "messages": [
      {
        "role": "system",
        "content": "You are a concise code review assistant."
      },
      {
        "role": "user",
        "content": "List three common mistakes when implementing retry logic in Python."
      }
    ],
    "max_tokens": 512,
    "temperature": 0.2
  }'

تستجيب الاستجابة الناجحة بهيكل إكمال الدردشة القياسي: مصفوفة choices، رسالة تحتوي على content، بيانات وصفية عن النموذج/تاريخ الإنشاء، وكائن usage يحتوي على عدد رموز المطالبة والإكمال والإجمالي.

استخدم هذا الاختبار السريع للتحقق من:

  • مفتاح API صالح ورأس التفويض منسق بشكل صحيح.
  • تم قبول معرف النموذج دون خطأ 404 أو خطأ عدم العثور على النموذج.
  • يمكن لعميلك تحليل choices[0].message.content.
  • يتم تسجيل استخدام الرموز لمراقبة التكلفة من الطلب الأول.

مثال على استخدام Kimi K2.7 Code مع Python

يعمل OpenAI Python SDK مع Novita AI عند تعيين عنوان URL الأساسي لـ Novita. قم بتثبيت إصدار SDK وفقًا لسياسة التبعية الخاصة بك.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ["NOVITA_API_KEY"],
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.7-code",
    messages=[
        {"role": "system", "content": "You are a concise code review assistant."},
        {
            "role": "user",
            "content": "Review this Python function for off-by-one errors and missing edge cases:\n\ndef get_items(lst, start, end):\n    return lst[start:end]",
        },
    ],
    max_tokens=512,
    temperature=0.2,
)

print(response.choices[0].message.content)
print("Tokens used:", response.usage.total_tokens)

لجلسات وكيل الترميز الطويلة، قم بتعيين max_tokens بشكل صريح. يدعم Kimi K2.7 Code ما يصل إلى 262,144 رمز إخراج، لكن الوكلاء الإنتاجيين يجب أن يخصصوا استخدام الرموز لكل جولة ويراقبوا التكلفة التراكمية عبر عمليات متعددة الخطوات.

إدخال الصور والفيديو

تسرد Novita النص والصورة والفيديو كطرق إدخال لـ Kimi K2.7 Code. لإدخال الصور، قم بتمرير مصفوفة content في رسالة المستخدم مع جزء text وجزء image_url:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ["NOVITA_API_KEY"],
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.7-code",
    messages=[
        {"role": "system", "content": "You are a UI code review assistant."},
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Describe any accessibility issues visible in this UI screenshot and suggest CSS fixes.",
                },
                {
                    "type": "image_url",
                    "image_url": {"url": "https://example.com/screenshot.png"},
                },
            ],
        },
    ],
    max_tokens=512,
)

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

الترتيب العملي للتكامل متعدد الوسائط:

  1. تأكد أولاً من نجاح الاختبار النصي فقط.
  2. أضف إدخال صورة واحد بمهمة يمكن التحقق منها بوضوح، مثل استخراج التسميات من لقطة شاشة واجهة المستخدم.
  3. تحقق من جودة الاستجابة وهيكل الاستجابة لعبء العمل الحقيقي.
  4. اختبر إدخالات الفيديو بشكل منفصل — ابدأ بمقاطع قصيرة، وتحقق من تنسيق الطلب، وقم بقياس زمن الوصول وتكاليف الرموز قبل إضافة الفيديو إلى مسار الإنتاج.

لا تفترض أن كل تحميل متعدد الوسائط متوافق مع OpenAI يتم قبوله بشكل مماثل من قبل كل نموذج مستضاف على Novita. تحقق من شكل تحميل الصورة والفيديو الدقيق في وثائق Novita AI الحالية أو أمثلة وحدة التحكم لـ moonshotai/kimi-k2.7-code قبل الشحن.

استدعاء الدوال والمخرجات المنظمة

يدعم Kimi K2.7 Code استدعاء الدوال من خلال معامل tools والمخرجات المنظمة من خلال response_format. يتم إدراج كليهما كميزات في صفحة نموذج Novita AI.

استخدم استدعاء الدوال عندما يجب أن يختار النموذج أداة ويعيد وسائط منظمة بدلاً من الإجابة بنثر:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ["NOVITA_API_KEY"],
)

tools = [
    {
        "type": "function",
        "function": {
            "name": "file_search",
            "description": "Search the repository for files matching a pattern.",
            "parameters": {
                "type": "object",
                "properties": {
                    "pattern": {
                        "type": "string",
                        "description": "Glob pattern to match, e.g. '**/*.py'",
                    },
                    "directory": {
                        "type": "string",
                        "description": "Root directory to search within.",
                    },
                },
                "required": ["pattern"],
            },
        },
    }
]

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.7-code",
    messages=[
        {"role": "system", "content": "You are a repository analysis assistant."},
        {
            "role": "user",
            "content": "Find all Python files in the src directory that might contain database migration logic.",
        },
    ],
    tools=tools,
    tool_choice="auto",
    temperature=0.1,
)

message = response.choices[0].message
if message.tool_calls:
    for call in message.tool_calls:
        print(f"Tool: {call.function.name}")
        print(f"Arguments: {call.function.arguments}")
else:
    print(message.content)

بالنسبة للمخرجات المنظمة، استخدم response_format مع json_schema عندما تحتاج إلى استجابة JSON تم التحقق منها دون استدعاء أداة. اجعل المخططات الأولية صغيرة واختبر المحلل الخاص بك مقابل شكل الاستجابة الدقيق الذي يرجعه moonshotai/kimi-k2.7-code قبل الاعتماد على الوضع الصارم في الإنتاج.

تعني بنية التفكير المتداخلة لـ Kimi K2.7 Code أنه يفكر في المهام متعددة الخطوات قبل إرجاع نتيجة. بالنسبة لسير عمل الترميز الوكيل مع استدعاءات أدوات متعددة لكل جولة، اختبر كيفية تصرف اختيار الأداة وجودة الوسائط وزمن استجابة الاستجابة على مجموعة المهام الفعلية قبل توجيه حركة المرور الإنتاجية.

قائمة التحقق من الاختبار الإنتاجي

يتم تسعير Kimi K2.7 Code بشكل منفصل لرموز الإدخال والإخراج وقراءة ذاكرة التخزين المؤقت. تختلف ملفات التكلفة بشكل كبير حسب عبء العمل:

  • مراجعة الكود ذات السياق الطويل: تهيمن أعداد رموز الإدخال الكبيرة على التكلفة.
  • وكلاء توليد الكود: يتزايد استخدام رموز الإخراج مع طول الاستجابة وعدد الجولات.
  • سير العمل ذات السياق المتكرر: ينطبق تسعير قراءة ذاكرة التخزين المؤقت عندما تتكرر مطالبة نظام مستقرة أو مخطط أداة أو ملخص مستودع عبر العديد من الاستدعاءات.

قبل الإنتاج، قم بتشغيل مجموعة تقييم تتضمن:

  • مطالبات نصية قصيرة فقط (خط الأساس لزمن الوصول والتحقق من المصادقة).
  • مطالبات ذات سياق طويل قريبة من حجم العمل المتوقع، وليس النافذة القصوى.
  • مطالبات استدعاء أدوات حيث يكون السلوك الصحيح هو استدعاء دالة مع وسائط صالحة.
  • إدخالات صور تطابق مصدر التحميل الفعلي ومعالجة الملفات.
  • حالات الفشل: إدخال كبير جدًا، رابط وسائط مفقود، مفتاح API غير صالح، وسلوك انتهاء المهلة.

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

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

هل Kimi K2.7 Code متاح من خلال Novita AI؟

نعم. تدرج Novita AI Kimi K2.7 Code كـ Serverless LLM بمعرف نموذج API moonshotai/kimi-k2.7-code.

ما هو معرف النموذج الصحيح؟

استخدم moonshotai/kimi-k2.7-code في جميع استدعاءات API.

ما هي نقطة النهاية التي يجب استخدامها؟

استخدم نقطة نهاية إكمال الدردشة المتوافقة مع OpenAI: POST https://api.novita.ai/openai/v1/chat/completions. قم بتعيين عنوان URL الأساسي إلى https://api.novita.ai/openai عند استخدام عميل OpenAI SDK.

كم تبلغ تكلفة Kimi K2.7 Code؟

اعتبارًا من 16 يونيو 2026، تسرد Novita AI 0.95 دولار لكل مليون رمز إدخال، و4.00 دولارات لكل مليون رمز إخراج، و0.19 دولار لكل مليون رمز إدخال قراءة ذاكرة التخزين المؤقت. تحقق من الأسعار الحالية في صفحة نموذج Kimi K2.7 Code قبل أي قرار شراء.

هل يدعم إدخال الصور والفيديو؟

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

هل يدعم Kimi K2.7 Code استدعاء الدوال؟

نعم. استخدم معامل tools في طلب إكمال الدردشة. تسرد Novita استدعاء الدوال والمخرجات المنظمة كميزات مدعومة.

ما هي نافذة السياق؟

نافذة سياق 262,144 رمزًا وحد أقصى للإخراج 262,144 رمزًا، كما هو مدرج في صفحة نموذج Novita AI.

مقالات موصى بها