Kimi K3.1 Pro

صيغ Kimi K3.1 Pro الأصلية Chat Completions وResponses وMessages. المعاملات الرسمية وسجل الاستدلال والمخرجات المنظمة والوسائط وحساب الذاكرة المؤقتة.

استخدم معرّف النموذج العام kimi-k3.1-pro. توفّر صفحة النموذج ساحة اللعب والأسعار الحالية. نزّل مواصفة OpenAPI للحصول على مخططات الطلبات والاستجابات المتداخلة كاملة.

البدء السريع

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"kimi-k3.1-pro",
    "messages":[{"role":"user","content":"How can an idempotency key prevent a duplicate payment?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

الصيغ الأصلية

الصيغة	نقطة النهاية	الحقول الإلزامية
Chat Completions	`POST /v1/chat/completions`	`model`, `messages`
Responses	`POST /v1/responses`	`model`, `input`
Messages	`POST /v1/messages`	`model`, `messages`, `max_tokens`

استخدم Authorization: Bearer $SEEDROUTER_API_KEY. يستخدم Messages أيضًا anthropic-version: 2023-06-01. تعيد كل صيغة JSON أصليًا أو أحداث SSE. لا يحتفظ Responses بالحالة: أعد إرسال السجل الكامل؛ فالحقل previous_response_id غير مدعوم في الطلب.

معاملات الطلب

تُحذف حقول ساحة اللعب الفارغة. تُحفظ القيم الصريحة false والصفر حيث تكون صالحة. الحذف لا يعني قبول null. تُهمل الامتدادات العليا غير المعروفة؛ وتُرفض الحقول الرسمية غير الصالحة. تبقى مخططات الأدوات المتداخلة والسجل المعاد كما هي.

Chat Completions

الحقل	النوع	إلزامي	الافتراضي / النطاق
`logprobs`	boolean	لا	الافتراضي false
`top_logprobs`	integer	لا	0–20; يتطلب logprobs=true
`prediction`	object	لا	يُحذف ما لم يُقدّم
`max_tokens`	integer	لا	1–1048576
`max_completion_tokens`	integer	لا	1–1048576; الافتراضي 131072
`response_format`	object	لا	يُحذف ما لم يُقدّم
`stop`	union	لا	≤5 سلاسل; ≤32 UTF-8 bytes لكل سلسلة
`stream`	boolean	لا	الافتراضي false
`stream_options`	object	لا	يُحذف ما لم يُقدّم
`tools`	array	لا	يُحذف ما لم يُقدّم
`prompt_cache_key`	string	لا	يُحذف ما لم يُقدّم
`prompt_cache_options`	object	لا	يُحذف ما لم يُقدّم
`safety_identifier`	string	لا	يُحذف ما لم يُقدّم
`tool_choice`	union	لا	يُحذف ما لم يُقدّم
`messages`	array	نعم	يُحذف ما لم يُقدّم
`reasoning_effort`	string	لا	low, high, max; الافتراضي "max"
`model`	string	نعم	kimi-k3.1-pro; الافتراضي "kimi-k3.1-pro"
`temperature`	number	لا	1
`top_p`	number	لا	0.95
`n`	integer	لا	1
`frequency_penalty`	number	لا	0
`presence_penalty`	number	لا	0

Responses

الحقل	النوع	إلزامي	الافتراضي / النطاق
`model`	string	نعم	kimi-k3.1-pro; الافتراضي "kimi-k3.1-pro"
`input`	union	نعم	يُحذف ما لم يُقدّم
`instructions`	string	لا	يُحذف ما لم يُقدّم
`stream`	boolean	لا	الافتراضي false
`max_output_tokens`	integer	لا	1–1048576; الافتراضي 131072
`reasoning`	object	لا	يُحذف ما لم يُقدّم
`text`	object	لا	يُحذف ما لم يُقدّم
`tools`	array	لا	يُحذف ما لم يُقدّم
`tool_choice`	object	لا	يُحذف ما لم يُقدّم
`include`	array	لا	يُحذف ما لم يُقدّم
`prompt_cache_key`	string	لا	يُحذف ما لم يُقدّم
`prompt_cache_options`	object	لا	يُحذف ما لم يُقدّم
`safety_identifier`	string	لا	يُحذف ما لم يُقدّم

Messages

الحقل	النوع	إلزامي	الافتراضي / النطاق
`model`	string	نعم	kimi-k3.1-pro; الافتراضي "kimi-k3.1-pro"
`messages`	array	نعم	يُحذف ما لم يُقدّم
`max_tokens`	integer	نعم	1–1048576
`system`	union	لا	يُحذف ما لم يُقدّم
`stream`	boolean	لا	الافتراضي false
`stop_sequences`	array	لا	≤5 سلاسل; ≤32 UTF-8 bytes لكل سلسلة
`tools`	array	لا	يُحذف ما لم يُقدّم
`tool_choice`	object	لا	يُحذف ما لم يُقدّم
`metadata`	object	لا	يُحذف ما لم يُقدّم
`cache_control`	object	لا	يُحذف ما لم يُقدّم
`output_config`	object	لا	يُحذف ما لم يُقدّم

لدى Chat عدد 22 حقلًا علويًا: model وخمسة حقول ثابتة لأخذ العينات و16 مدخلًا متغيرًا. لدى Responses حقل model و12 مدخلًا؛ ولدى Messages حقل model و10 مدخلات. تخفي ساحة اللعب النموذج الثابت وعناصر التحكم الثابتة لأخذ العينات.

الاستدلال وحدود الإخراج

التفكير مفعّل دائمًا. تقبل Chat reasoning_effort وResponses reasoning.effort وMessages output_config.effort القيم low أو high أو max؛ والافتراضي max. تشمل كل حدود الإخراج الاستدلال. الافتراضي في Chat وResponses هو 131,072 توكن إخراج، بحد أقصى 1,048,576. يتطلب Messages قيمة موجبة لـ max_tokens. يقبل Chat الحقل المهمل max_tokens؛ ويُفضّل max_completion_tokens للدمج الجديد.

نافذة السياق 1,048,576 توكن. يجب أن يسعها الإدخال نفسه. إذا تجاوز الإدخال وميزانية التوليد النافذة، فقد تخفض الخدمة الميزانية إلى المساحة المتبقية. قد يوقف حد إخراج صغير التوليد قبل ظهور أي إجابة مرئية.

أخذ العينات في Chat ثابت: temperature:1 وtop_p:0.95 وn:1 وfrequency_penalty:0 وpresence_penalty:0. القيم الأخرى غير صالحة. تطابق سلاسل التوقف النص بدقة وتُستبعد من الإجابة. يحسب حد 32 بايت بايتات UTF-8 لا الأحرف.

المخرجات المنظمة والتوقعات

يقبل Chat القيم text أو json_object أو json_schema في response_format.type. يحتاج وضع JSON أيضًا إلى موجّه يطلب JSON. يتطلب JSON Schema الحقلين json_schema.name وjson_schema.schema؛ وstrict افتراضيًا true.

يستخدم Responses الحقل text.format مع type:json_schema وschema وname وstrict الاختياريين. يستخدم Messages الحقل output_config.format مع type:json_schema وschema. اتبع Moonshot Flavored JSON Schema؛ ولا تفترض فرض كل امتداد عام لـ JSON Schema. تحقق من المخرجات المكتملة في تطبيقك.

يستخدم إخراج Chat المتوقع prediction:{type:"content",content:...}. المحتوى سلسلة أو أجزاء نصية فقط. استخدمه للإخراج المعروف في معظمه، مثل ملف يتلقى تعديلًا صغيرًا.

الأدوات والاحتفاظ بسجل المحادثة

تستخدم أدوات Chat القيمة type:function مع function.name وfunction.parameters. تشمل الحقول الاختيارية description وstrict (افتراضيًا true). تطابق الأسماء ^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$. يدعم اختيار الأداة auto وnone وrequired؛ وتتطلب required أداة متاحة واحدة على الأقل. يتعارض فرض دالة باسمها مع التفكير المفعّل دائمًا.

رسالة أدوات Chat الديناميكية هي {role:"system",tools:[...]} دون content. احتفظ بهذه الرسائل في المحادثة. ألحق رد المساعد كاملًا، بما فيه reasoning_content وtool_calls، ثم أعد كل نتيجة أداة برسالة role:tool مع tool_call_id المطابق. يمكن لردود المساعد التي تستدعي الأدوات أن تحمل content بقيمة null. ما زالت أدوار الرسائل الأخرى تتطلب content.

يدعم Responses تعريفات الأدوات الأصلية function وnamespace وapply_patch المخصص وweb_search مع tool_choice:"auto". أعد عناصر function_call_output أو custom_tool_call_output مع معرّفات الاستدعاء المطابقة. تؤثر قيم include وهي web_search_call.results وweb_search_call.action.sources في مخرجات البحث على الويب فقط.

يدعم Messages تعريفات أدوات أصلية وكائنات اختيار الأداة بالقيم type auto أو any أو none. احتفظ بكتل تفكير المساعد وتوقيعاتها. أعد كتل نتائج الأدوات ضمن رسائل المستخدم. يتحقق تطبيقك من الوسائط وينفذ الدوال المخصصة ويتحكم في الإجراءات الخارجية.

يضبط Chat Partial Mode القيمة partial:true على رسالة المساعد الأخيرة فقط. يتابع Messages رسالة المساعد الأخيرة مباشرة. لا تُعد بناء السجل من نص الإجابة الظاهر وحده.

قيود الوسائط

يقبل Chat كتل محتوى text وimage_url وvideo_url. استخدم عناوين data URL بترميز base64 أو مراجع ms:// المقبولة؛ ولا تُدعم روابط الوسائط العامة العشوائية. صيغ الصور: JPEG وPNG وGIF وWebP وBMP وHEIC وHEIF. صيغ الفيديو: MP4 وMPEG وMOV وAVI وFLV وMPG وWebM وWMV و3GPP. يحدد الدليل الرسمي حدًا إجماليًا لجسم الطلب يبلغ 100M دون حد منفصل لعدد الصور. صور 4K وفيديو Full HD توصيات وليست حدودًا إلزامية.

يستخدم Responses الحقل input_image.image_url مع data URL. يستخدم Messages مصدر صورة مثل {type:"base64",media_type:"image/png",data:"..."}، أو type url مع مرجع ms:// مقبول. صيغ صور Messages المضمنة هي JPEG وPNG وGIF وWebP. لا ترث هذه الصيغ كتلة فيديو Chat ضمنيًا؛ استخدم مخططاتها المخصصة.

ترفق ساحة اللعب صورًا مضمنة. استخدم حقول المحادثة الأصلية أو محرر JSON لكتل الفيديو ومراجع الملفات. رفع الملفات وإدارتها خارج نطاق نقاط التوليد هذه. لا يكون معرّف ملف أُنشئ بحساب آخر صالحًا للاستخدام بالضرورة.

التخزين المؤقت والاستخدام

يستخدم Chat وResponses الحقلين prompt_cache_key وprompt_cache_options:{mode:"implicit",ttl:"5m"}. تقبل TTL القيمتين 5m أو 1h، والافتراضي 5 دقائق. يستخدم Messages الحقل العلوي cache_control:{type:"ephemeral",ttl:"5m"} وmetadata.user_id الاختياري. تُهمل علامات cache-control المتداخلة في Messages. الحقل prompt_cache_breakpoint على مستوى المحتوى غير صالح.

تحتفظ البادئة المخزّنة بمدة TTL الأصلية عند تحديثها. طلب مدة مختلفة لا يثبت تطبيقها. تبلغ ترويسات Chat الرسمية لكتابة الذاكرة المؤقتة عن الأعداد الفعلية لفئتَي 5 دقائق وساعة. قد يعيد Responses الحقل prompt_cache_options المطبق؛ ويبلغ Messages عن عدّادي TTL في usage.cache_creation.

الصيغة	إجمالي الإدخال	قراءة الذاكرة المؤقتة	كتابة الذاكرة المؤقتة
Chat	`usage.prompt_tokens`	`prompt_tokens_details.cached_tokens`	`prompt_tokens_details.cache_write_tokens`
Responses	`usage.input_tokens`	`input_tokens_details.cached_tokens`	`input_tokens_details.cache_write_tokens`
Messages	`input_tokens + cache_read_input_tokens + cache_creation_input_tokens`	`cache_read_input_tokens`	`cache_creation_input_tokens`

تشمل مجاميع الإدخال في Chat وResponses قراءات الذاكرة المؤقتة وكتاباتها بالفعل. هذه الفئات وبقية الإدخال غير المخزّن منفصلة؛ فلا تضف توكنات الذاكرة المؤقتة مرتين. يشمل الإخراج الاستدلال. يفصل Messages الكتابات إلى ephemeral_5m_input_tokens وephemeral_1h_input_tokens. راجع الأسعار الحالية؛ لا تحتوي استجابات التوليد العامة على رسوم مالية.

البث والاكتمال

اضبط stream:true. يصدر Chat أجزاء بيانات و[DONE]؛ ويطلب stream_options.include_usage:true جزء الاستخدام النهائي. يستخدم Responses أحداثًا مسماة مثل response.output_text.delta وresponse.completed وresponse.incomplete. يستخدم Messages أحداث message_start وأحداث كتل المحتوى وmessage_delta وmessage_stop.

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

المراجع الرسمية

تم التحقق في 25 أكتوبر 2026: دليل ⁦Kimi K3.1 Pro⁩، وChat، وResponses، وMessages، والرؤية، والتخزين المؤقت.

On this page