# واجهة API لـ GLM 5.2

مرجع API كامل لنماذج LLM من GLM 5.2 المدعومة بواسطة Z.ai.

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

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

| النموذج | ID | الوصف |
|-------|----|-------------|
| **GLM 5.2 Text to Text** | `glm-5.2-text-to-text` | استدلال وكتابة نصية عامة |

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

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

## GLM 5.2 Text to Text

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

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

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

#### مطلوبة

| المعلمة | النوع | الوصف |
|-----------|------|-------------|
| `model` | string | يجب أن تكون `"glm-5.2-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: 'glm-5.2-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a four-line modern poem about a programmer drinking coffee.'
      }
    ],
    stream: true,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});
```

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

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

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

- يدعم GLM 5.2 حاليا الإدخال النصي فقط عبر هذا المسار.
- استخدم `top_p` و`top_k` معا عندما تحتاج إلى تحكم أدق في تنوع الإخراج.
- حافظ على بنية واضحة للموجهات عند توليد محتوى طويل أو كود.