واجهة Kimi K3 البرمجية

مرجع كامل لواجهة API الخاصة بنماذج Kimi K3 اللغوية الكبيرة والمشغلة بواسطة Moonshot AI.

متغيرات النموذج

تدعم واجهة API متغيرًا واحدًا من النموذج:

النموذج	المعرّف	الوصف
Kimi K3 Text to Text	`kimi-k3-text-to-text`	الاستدلال والكتابة النصية للأغراض العامة

مقارنة سريعة

الميزة	تحويل النص إلى نص
إدخال النص	مطلوب ✅
إدخال الصور	غير مدعوم ❌
إدخال الملفات	غير مدعوم ❌
الاستجابة المتدفقة	SSE
`max_tokens`	اختياري
`top_k`	اختياري

Kimi K3 لتحويل النص إلى نص

نقطة النهاية

http
POST /api/v1/chat/completions

معلمات الطلب

مطلوبة

المعلمة	النوع	الوصف
`model`	string	يجب أن تكون `"kimi-k3-text-to-text"`
`messages`	array	الرسائل المرتبة. راجع واجهة LLM API لمعرفة بنية الرسائل.
`stream`	boolean	القيمة `true` لـ SSE، والقيمة `false` لاستجابة JSON واحدة.

دعم الرسائل

الحقل	النص	الملف	الصورة
`messages`	مطلوب ✅	غير مدعوم ❌	غير مدعوم ❌

اختيارية

المعلمة	النوع	النطاق	الوصف
`max_tokens`	integer	`> 0`	الحد الأقصى لرموز الإخراج. لا يوجد حد أقصى افتراضي.
`top_k`	integer	`> 0`	يحد من عدد الرموز المرشحة.

مثال على الطلب

javascript
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'kimi-k3-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a concise Java beginner tutorial outline.'
      }
    ],
    stream: true,
    max_tokens: 2000,
    top_k: 50
  })
});

تنسيق الاستجابة

يعيد Kimi K3 استجابات إكمال متوافقة مع OpenAI. عند استخدام stream: true، تكون الاستجابة في صورة Server-Sent Events؛ وعند استخدام stream: false، تكون الاستجابة كائن JSON واحدًا.

أفضل الممارسات

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

النموذج

المعرّف

الوصف

Kimi K3 Text to Text

kimi-k3-text-to-text

الاستدلال والكتابة النصية للأغراض العامة

الميزة

تحويل النص إلى نص

إدخال النص

مطلوب ✅

إدخال الصور

غير مدعوم ❌

إدخال الملفات

غير مدعوم ❌

الاستجابة المتدفقة

SSE

max_tokens

اختياري

top_k

اختياري

Kimi K3 لتحويل النص إلى نص

نقطة النهاية

http

POST /api/v1/chat/completions

معلمات الطلب

مطلوبة

المعلمة	النوع	الوصف
`model`	string	يجب أن تكون `"kimi-k3-text-to-text"`
`messages`	array	الرسائل المرتبة. راجع واجهة LLM API لمعرفة بنية الرسائل.
`stream`	boolean	القيمة `true` لـ SSE، والقيمة `false` لاستجابة JSON واحدة.

دعم الرسائل

الحقل	النص	الملف	الصورة
`messages`	مطلوب ✅	غير مدعوم ❌	غير مدعوم ❌

اختيارية

المعلمة	النوع	النطاق	الوصف
`max_tokens`	integer	`> 0`	الحد الأقصى لرموز الإخراج. لا يوجد حد أقصى افتراضي.
`top_k`	integer	`> 0`	يحد من عدد الرموز المرشحة.

مثال على الطلب

javascript

const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'kimi-k3-text-to-text', messages: [ { role: 'user', content: 'Write a concise Java beginner tutorial outline.' } ], stream: true, max_tokens: 2000, top_k: 50 }) });