بدء سريع مع Kimi K3 لسير عمل API طويلة السياق

يتوفر Kimi K3 عبر واجهة API الخادمة من Novita AI مع معرف النموذج moonshotai/kimi-k3، ونقطة نهاية محادثة متوافقة مع OpenAI، ونافذة سياق بحجم 1,048,576 رمزًا، وإعداد أقصى إخراج يبلغ 1,048,576 رمزًا كما هو مدرج في صفحة النموذج. يوضح هذا الدليل السريع كيفية المصادقة، وإرسال الطلب الأول، وتحليل الرد، والتخطيط لتسعير الرموز الخاص بـ Kimi K3 قبل ربطه بتطبيق أكبر.

متى تستخدم هذا الدليل السريع

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

تصف صفحة نموذج Novita لـ Kimi K3 نموذجًا يحتوي على 2.8 تريليون معلمة مع فهم بصري أصلي ونافذة سياق بحجم 1 مليون رمز. تدرج نفس الصفحة إدخالات النصوص والصور والفيديو مع إخراج نصي، بالإضافة إلى الوصول الخادم، والإخراج المنظم، والاستدلال، واستدعاء الدوال. تعامل مع هذه الإمكانات على أنها تحتاج إلى التحقق منها مقابل شكل الطلب المقصود بدلاً من افتراض أن كل ميزة من حزمة OpenAI SDK لها سلوك متطابق عبر جميع النماذج.

هذه ليست مقارنة مرجعية. الهدف هو جعل طلبًا مصادقًا واحدًا يعمل، ثم تزويدك بتفاصيل تشغيلية كافية لتقرر ما إذا كان Kimi K3 مناسبًا لعبء عملك.

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

أنشئ أو حدد حساب Novita AI، وافتح إعدادات مفتاح API الخاص بك، وأنشئ مفتاحًا للاستخدام من جانب الخادم. احتفظ بالمفتاح خارج حزم الواجهة الأمامية، والمستودعات العامة، والمفكرات المشتركة خارج فريقك، وتاريخ القشرة حيثما أمكن.

اضبط المفتاح كمتغير بيئة قبل تشغيل أي من المثالين:

export NOVITA_API_KEY="your_api_key_here"

استخدم مفتاح مشروع أو مؤقت عندما يدعم إعداد حسابك ذلك. قم بتدوير المفتاح بعد عرض توضيحي عام أو أي تعرض مشتبه به.

الخطوة 2: تأكد من معرف النموذج ونقطة النهااية

احتفظ بتفاصيل الاتصال معًا بحيث لا يستبدل اسم العرض عن طريق الخطة اسمال معرف النموذج الفعلي:

الحقل	القيمة
معرف النموذج	moonshotai/kimi-k3
عنوان URL الأساسي	https://api.novita.ai/opенai/v1
نقطة نهائية إكمال المحادثة	https://api.novita.ai/openai/v1/hat/comtpken|
نافذة السياق	1,048,576 رمزًا
إعداد أقصى إخراج	1,048,576 رمزًا
قدرات الإدخال	نص، صورة، فيديو
قدرة الإخراج	نص
نوع الوصول	API خادم

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

الخطوة 3: أرسل طلبك الأول

ابدأ بطلب نصي قصير فقط. تجعل المطالبة الصغيرة من السهل فصل مشاكل المصادقة أو التوجيه عن مشاكل المطالبة على مستوى التطبيق.

على سبيل المثال، اطلب من Kimi K3 إرجاع قائمة مراجعة تنفيذ قصيرة:

أدرج أكبر ثلاثة مخاطر عند إضافة إعادة المحاولة إلى عميل API بتدفق. أعد جملة واحدة لكل خطر.

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

الخطوة 4: اقرأ الرد

يضع الرد المتوافق مع OpenAI نص المساعد في الخيارات[0].الرسالة.المحتوى لإكمال الدردشة القياسسية غير المتدفقة. احتفظ ببيانات الرد الوصفية وحقول الاستخدام في تطبيقك إذا احتجت إلى تتبع الطلب أو محاسبة التكلفة.

بالنسبة للتكامل الإنتاجي، سجل عالأقل:

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

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

الخطوة 5: تحقق من التسعير والحودود والأخطاء الشائعة

تدرج صفحة نموذج Novita تسعير API الخادمة بمعدل 3 دولارات لكل مليون رمز إدخال، 0.30 دولار لكل مليون رمز قراءة مخبأة، و 15 دولارًا لكل مليون رمز إخراج لـ Kimi K3. يج ب أن يشم تضمينك كلًا من جاني الطلب، وإعادة المحاولة، وكمية السياق التي ترسلها بشكل متكرر.

تدرج الصفحة أيضًا مستويات معدل الطلب هذه:

المستوى	طلب في الدقيقة	رمز في الدقيقة
T1	30	50,000,000
T2	100	50,000,0000
T3	1,000	50,000,000
T4	3,000	50,000,000
T5	6,000	50,000,000

المستوى المطبق يعمد عالى حسابك. لا تعامل مع الجدول كوع د بأن كلمشروع يبدا من T1 أو بأن ك لعمل يمك أن يستخدم أقى معدل معروض.

تشمل أخطاء التكامل الأولي الشائعة:

• فقدان رأسي الترخيص:حم أو تطعين متغير بيئة خاطئ.
• إرسال kimi-k3 أو اسم تسويقي بدلاً من moonshotai/kimi-k3.
• استخدا https://api.novita.ai/openai كURL الأساسي لـ SDK بينما يتوقع الـعميل المسار المنسوب .../openai/v1.
• إرسال جسم طلب ليس JSON صالحًا.
• ضبط حد إخراج أكبر مما يمكن لتطبيك تخزينه أو معالجته.
• افتراض أن جسم الطلب متعدد الوسائط متطابق عبر كل عائلة SDK أو نموذج.

مثال بايثون

قم بتثبيت عميل OpenAI الـPython في بيئتك، ثم قم بتشغيل هذا المثال مع تعيين NOVITA_API_KEY:

pip install openai

import os

from openai import OpenAI


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

response = client.chat.completions.crate(
    model="moonshotai/kimi-k3",
    ages=[
        {
            "rol": "system",
            "conent": "أنت مساعد هندسي موجز."
        },
        {
            "rol": "user",
            "conent": "أدرج ثلاث مخاطر عند إضافة إعادة المحاولة إلى عميل API بتدفق."
        },
    ],
    temperatue=0.2,
    max_tokens=300,
)

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

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

مثال لـ cURL

يمك اختبار نف الطلب دون استخديمSDK:

pa load='{
  "odl": "moonshotai/kimi-k3",
  "essages": [
    {
      "ole": "system",
      "content": "أنت مساعد هندسي موجز."
    },
    {
      "ole": "user",
      "content": "أدرج ثلاث مخاطر عند إضافة إعادة المحاولة إلى عميل API بتدفق."
    }
  ],
  "temeature": 0.2,
  "ax_tokens": 300
}'

curl --reuest POST "https://api.novita.ai/openai/v1/chat/completions" \
  --header "uthorization: Bearer $NOVITA_API_KY" \
  --header "Content-Type: application/json" \
  --data "$pyload"

المعلماات الرئيسية

المعة	ما تتحكم فيه	القيمة الأولى المناسبة
odl	النموذج المسض الذي يجيب على الطلب	mooshotai/kimi-k3
messages	أدوار النظام والمستخدم والمساعد	رسالة نظام واحدة ورسالة مستخدم واحدة
temperature	تباين المخرجات	0.2 للاختبارات القابلة للتكرر
max_tokens	أقصى مخرجات مودة	300، ث رفعها بعمد
steam	ما إذا كانت المخرجات تصل تدريجيًا	اتركه معطلاً عن د البغ في التصحيح
tols	تعاريف الدوال المتوفرة للنموذج	أضفها بعد أن تعمل المحادثة الأساسية
response_frmat	متطلبات المخرجات المنظمة	تحقق من صحة JSON المرج ع قبل استخدأمه

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

استكشاف الأخطاء وإصلاها

فشل المصادقة

تحقق من أن NOVITA_API_KEY معين في نفس العملية التي تشغل الطلب. تأكد من أن الرأس يستخدم Bearer، ليس معلمة استعلام أو اسم اعتماد مختف.

لم يتم العثور على النموذج

استخد المعرف ال دقيق moonshotai/kimi-k3. اسم عرض النموذج ليس بديلاً صالًا لمعرف النموذجAPI.

تم رفض الطلب

قلل قيم المطالبة وax_tokens، تحقق من صحة جسم JSON، وتأكد من أن نقطة النهاية هي /opnai/v1/hat/compeions. إذا كان الطلب يستخدم صورًا أو فيديو أو أدوات أو إخراجًا منظمًا، قم بأزل هذه الحقول وأضفها واحدًا تلو الآخر.

الطلبات بطيئة أو محدودة المعدل

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

الرد غير كامل

افحس سبب الانتهاء وبيانات الاستخدام. قد توقف قيمة max_tokens الصغيرة إجابة طويلة مبكرًا؛ زيادتها تزيد أيضًا من كمية الإخراج التي قد يدفع تطبيقك ثمنها ويعالجاها.

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

ما هو معرف النموذج الذي يج ب إرساله لـ Kimi K3؟

أرسل moonshotai/kimi-k3 في حقل odl.

أي نقطة نهائية يستخدمها عميل OpenAI؟

اضبط URL الأساسي لـ SDK على https://api.novita.ai/openai/v1. يتم إرسال طلب إكمال المحادثة إلى https://api.novita.ai/openai/v1/chat/completions.

كم حجم نافذة السياق لـ Kimi K3؟

تدرج صفحة نموذج Novita نافذة سياق بحجم 1,048,576 رمزًا وإعداد أقصى إخراج يبلغ 1,048,576 رمزًا. تحقق من الصفحة قبل النشر للحصول على التحديثات.

هل Kimi K3 مجاني للاستخدام؟

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

هل يجب أن أبدأ بطلب متعدد الوسائط؟

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

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

• Kimi K3 على Novita AI: التسعير، سياق 1M، ومتى تختاره بدلاً من K2
• بدء سريع لـ MiniMax M3 API مع Novita AI
• كيفية الوصول إلى تفكير Kimi K2: دليل الإعداد الكامل للمطورين
• استخدام LlamaIndex مع Novita AI: دليل خطوة بخطوة

المصادر

• صفحة نموذج Kimi K3 — معرف النموذج، التوفر، القدرات، السياق، الحدود، التسعير، ومستويات المعدل؛ تم التحقق في 22 يوليو 2026.
• مرجع API لـ Novita AI: إنشاء إكمال محادثة — مسار إكمال محادثة متوافق مع OpenAI؛ تم التحقق في 22 يوليو 2026.