واجهة 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 معا عندما تحتاج إلى تحكم أدق في تنوع الإخراج.
حافظ على بنية واضحة للموجهات عند توليد محتوى طويل أو كود.

النموذج

الوصف

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 حاليا الإدخال النصي فقط عبر هذا المسار.

استخدم top_p وtop_k معا عندما تحتاج إلى تحكم أدق في تنوع الإخراج.

حافظ على بنية واضحة للموجهات عند توليد محتوى طويل أو كود.