# Kimi 2.7 API

مرجع API كامل لنماذج Kimi 2.7 LLM المدعومة من Moonshot AI.

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

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

| النموذج | ID | الوصف |
|-------|----|-------------|
| **Kimi 2.7 Text to Text** | `kimi-2.7-text-to-text` | استدلال وكتابة نصية عامة |
| **Kimi 2.7 Image to Text** | `kimi-2.7-image-to-text` | فهم الصور مع تعليمات نصية |

## مقارنة سريعة

| الميزة | نص إلى نص | صورة إلى نص |
|---------|--------------|---------------|
| إدخال النص | مطلوب ✅ | اختياري |
| إدخال الصورة | غير مدعوم ❌ | اختياري |
| استجابة البث | SSE | SSE |
| `max_tokens` | اختياري | اختياري |
| `top_p` | اختياري | اختياري |
| `top_k` | اختياري | اختياري |

## Kimi 2.7 Text to Text

### نقطة النهاية

```http
POST /api/v1/chat/completions
```

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

#### مطلوب

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

#### دعم الرسائل

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

#### اختياري

| المعامل | النوع | النطاق | الوصف |
|-----------|------|-------|-------------|
| `max_tokens` | integer | `> 0` | الحد الأقصى لرموز الإخراج. |
| `top_p` | number | `0.0` - `1.0` | يحد من كتلة الاحتمال التراكمية للرموز المرشحة. |
| `top_k` | integer | `0` - `100` | يحد من عدد الرموز المرشحة. |

### مثال طلب

```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-2.7-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a concise Java beginner tutorial outline.'
      }
    ],
    stream: true,
    max_tokens: 2000,
    top_p: 0.9,
    top_k: 50
  })
});
```

## Kimi 2.7 Image to Text

### نقطة النهاية

```http
POST /api/v1/chat/completions
```

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

#### مطلوب

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

#### دعم الرسائل

| الحقل | نص | ملف | صورة |
|-------|------|------|-------|
| `messages` | اختياري | غير مدعوم ❌ | اختياري |

#### اختياري

| المعامل | النوع | النطاق | الوصف |
|-----------|------|-------|-------------|
| `max_tokens` | integer | `> 0` | الحد الأقصى لرموز الإخراج. |
| `top_p` | number | `0.0` - `1.0` | يحد من كتلة الاحتمال التراكمية للرموز المرشحة. |
| `top_k` | integer | `0` - `100` | يحد من عدد الرموز المرشحة. |

### مثال طلب

```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-2.7-image-to-text',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'What is roughly shown in this image?' },
          {
            type: 'image_url',
            image_url: {
              url: 'https://example.com/sample-image.jpg'
            }
          }
        ]
      }
    ],
    stream: true,
    max_tokens: 300
  })
});
```

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

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

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

- استخدم تعليمات نظام موجزة للسلوك الخاص بالمهمة.
- لفهم الصور، اقرن سؤالا واضحا بمحتوى مرفق الصورة في `messages[].content`.
- اضبط `top_p` و`top_k` فقط عندما تحتاج إلى مخرجات أكثر صرامة أو أكثر تنوعا.