واجهة برمجة تطبيقات GLM-5 API، من الطلب الأول حتى مرحلة الإنتاج

يتم تقديم كل نموذج من نماذج GLM-5 عبر واجهة برمجة تطبيقات لإكمال المحادثة متوافقة مع OpenAI. يمكنك استدعاؤها على منصة Z.ai الخاصة أو عبر OpenRouter. يغطي هذا الدليل كلا الخيارين، متضمناً الأسعار، ومعرّفات النماذج، والتحكم في التفكير، وإدخال الصور، وشفرات برمجية جاهزة للنسخ.

الانتقال إلى الشفرة البرمجية جربها في المحادثة المجانية

رسم توضيحي بنمط المخططات الهندسية لطلبات API المتدفقة بين حاسوب محمول ورف خوادم

§ 01مساران متاحان

أين يمكنك استدعاء GLM-5

منصة Z.ai

تدير Z.ai، الشركة المطورة لنموذج GLM، واجهة برمجة التطبيقات الخاصة بها. نقطة النهاية العامة هي https://api.z.ai/api/paas/v4/chat/completions وتتبع بروتوكول إكمال المحادثة الخاص بـ OpenAI، لذا تعمل مكتبات OpenAI SDKs الرسمية بمجرد تغيير رابط base URL. توثق Z.ai أيضاً نقطة نهاية للبرمجة (https://api.z.ai/api/coding/paas/v4)، ونقطة نهاية بنمط Responses ‏(https://api.z.ai/api/v1)، ونقطة نهاية متوافقة مع Anthropic ‏(https://api.z.ai/api/anthropic) للأدوات التي تتطلب هذه الصيغ.

تكون رموز النماذج قصيرة على Z.ai: مثل glm-5.3 وglm-5.3-flash وglm-5.3-flashx. يتم تفعيل التفكير باستخدام "thinking": {"type": "enabled"}، ويتم تحديد العمق بواسطة reasoning_effort. ستحتاج إلى حساب على Z.ai ومفتاح API؛ راجع صفحة الأسعار الخاصة بـ Z.ai للاطلاع على أسعارها الحالية.

OpenRouter

تُعد OpenRouter منصة تجميع: يمنحك مفتاح واحد ونقطة نهاية واحدة (https://openrouter.ai/api/v1/chat/completions) الوصول إلى كل نموذج من نماذج GLM-5 إلى جانب نماذج من مختبرات أخرى. تحمل معرّفات النماذج بادئة المزوّد — مثل z-ai/glm-5.3 وz-ai/glm-5.3-flash وما إلى ذلك — ويتم التحكم في التفكير باستخدام كائن reasoning واحد مثل {"effort": "low"}.

الأسعار الواردة في الجدول أدناه خاصة بـ OpenRouter. كما أن OpenRouter هي الطريقة التي يُشغّل بها هذا الموقع محادثته المجانية، لذا فإن الأداء الذي تراه في محادثتنا هو تماماً ما ستحصل عليه عبر واجهة برمجة التطبيقات.

اختر Z.ai إذا كنت تفضل منصة المطور المباشرة، أو نقطة النهاية المخصصة للبرمجة، أو الوصول المتوافق مع Anthropic.
اختر OpenRouter إذا كنت تريد فاتورة واحدة لعائلات نماذج متعددة وسهولة التبديل بينها.
في كلتا الحالتين، يظل الكود الخاص بك هو نفس الطلب بأسلوب OpenAI مع اختلاف base URL واسم النموذج فقط.

§ 02الأسعار

أسعار GLM-5 API على OpenRouter

بالدولار الأمريكي لكل 1 مليون رمز، بالإضافة إلى تقدير لتكلفة 1,000 جولة محادثة نموذجية. انقر على أي نموذج للاطلاع على دليله الكامل.

أسعار GLM-5 API على OpenRouter
النموذج	معرّف النموذج	السياق	المدخلات / 1M	المخرجات / 1M	1,000 محادثة*
GLM-5	z-ai/glm-5	205K	$1	$3.20	$3.74
GLM-5-Turbo	z-ai/glm-5-turbo	203K	$1.20	$4	$4.60
GLM-5V-Turbo	z-ai/glm-5v-turbo	203K	$1.20	$4	$4.60
GLM-5.1	z-ai/glm-5.1	205K	$1.40	$4.40	$5.18
GLM-5.2	z-ai/glm-5.2	1.05M	$0.0341	$7	$4.95
GLM-5.3	z-ai/glm-5.3	1.05M	$0.079	$1.40	$1.10
GLM-5.3 Flash	z-ai/glm-5.3-flash	1.05M	$0.0052	$0.1985	$0.15
GLM-5.3 FlashX	z-ai/glm-5.3-flashx	1.05M	$0.37	$1.25	$1.43
GLM-5.3 Prime	z-ai/glm-5.3-prime	1M	$2.80	$8.80	$10

*1,000 جولة محادثة تتضمن كل منها 1,500 رمز إدخال و700 رمز إخراج. الأسعار مأخوذة من قائمة نماذج OpenRouter وقت كتابة هذا الدليل؛ وتُحسب رموز التفكير كمخرجات.

§ 03الكود

طلبات جاهزة للنسخ

عيّن مفتاحك في متغير بيئة — ولا تضعه أبداً في كود من جانب العميل أو في مستودع عام.

OpenRouter

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-ai/glm-5.3",
    "messages": [
      {"role": "system", "content": "You are a concise senior engineer."},
      {"role": "user", "content": "Explain idempotency keys in two paragraphs."}
    ],
    "reasoning": {"effort": "low"},
    "max_tokens": 1024,
    "stream": false
  }'

منصة Z.ai

curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "Summarise the CAP theorem."}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "low"
  }'

تستخدم Z.ai رموز نماذج قصيرة (glm-5.3، glm-5.3-flash) ومفتاح تبديل منفصلاً للتفكير. راجع وثائق Z.ai للاطلاع على أحدث المعلمات والحدود.

§ 04التفاصيل

المعلمات الأكثر أهمية

التفكير جزء من الإجابة

يقوم GLM-5.3 دائمًا بالتفكير المنطقي قبل الإجابة؛ ويمكنك تحديد مقداره. تسرد بطاقة النموذج الخاصة به ثلاثة مستويات لـ reasoning_effort — هي low وhigh وmax — وتشير إلى أن الافتراضي هو max إذا لم تقم بتمرير أي قيمة. بالنسبة للمحادثات والأدوات البسيطة، عيّن جهدًا منخفضًا (low) بشكل صريح: ستصل الإجابات بشكل أسرع وبتكلفة أقل، لأن توكنز التفكير تُحسب كرموز إخراج.

عند البث عبر OpenRouter، يصل التفكير في delta.reasoning بينما يصل النص النهائي في delta.content. اعرض الأول كلوحة "تفكير" قابلة للطي أو قم بإخفائها، لكن لا تعد لصقها مرة أخرى في سجل المحادثة.

إرسال الصور إلى GLM-5.3 Flash

يدعم كل من GLM-5.3 Flash وGLM-5.3 FlashX وGLM-5V-Turbo استقبال الصور. أرسل رسالة المستخدم كمصفوفة من الأجزاء: جزء نصي وجزء image_url يحتوي على عنوان URL إما كرابط HTTPS عام أو عنوان بيانات base64 مثل data:image/jpeg;base64,… يُعد GLM-5.3 وGLM-5.3 Prime نصيين فقط، لذا وجّه طلبات الصور إلى Flash.

قم بتغيير حجم الصور الكبيرة قبل إرسالها. يضمن جعل الضلع الأطول حوالي 1,024 بكسل بقاء حجم الطلب صغيرًا، وهو كافٍ لمعظم الأسئلة المتعلقة بالمستندات والرسوم البيانية ولقطات الشاشة.

حدود السياق والمخرجات

يسرد كل من GLM-5.2 وGLM-5.3 وGLM-5.3 Flash سياقًا يبلغ 1,048,576 توكن على OpenRouter، وما يصل إلى 943,718 توكن إخراج. هذا لا يعني أنه ينبغي عليك استخدامها بالكامل في كل طلب: فتوكنز الإدخال غير مكلفة في هذه النماذج، لكن المخرجات الطويلة ليست كذلك، لذا ضع حدًا لـ max_tokens بما يتناسب مع ما يمكن لواجهتك عرضه.

بالنسبة للوكلاء (agents)، حافظ على ثبات موجه النظام (system prompt) وأضف إلى المحادثة بدلاً من إعادة كتابتها؛ إذ يمكن للمزودين الذين يتيحون التخزين المؤقت للموجهات (prompt caching) إعادة استخدام العمليات السابقة.

استخدم stream: true لأي طلب ينتظر شخص إجابته.
أعد محاولة إرسال الطلبات التي تُرجع رموز الخطأ 429 و502 و503 مع فترة انتظار تصاعدية قصيرة (backoff).
سجّل بيانات الاستخدام من الجزء الأخير (final chunk) لتتبع إنفاقك.

§ 05الأسئلة الشائعة

أسئلة حول واجهة برمجة تطبيقات GLM-5

Q01هل تتوافق واجهة برمجة تطبيقات GLM-5 مع مكتبة OpenAI SDK؟

نعم. تقبل كل من نقطة نهاية Z.ai وOpenRouter طلبات إكمال المحادثات (chat completions) بأسلوب OpenAI. ما عليك سوى توجيه عنوان URL الأساسي لمكتبة SDK إلى المزود واستخدام اسم نموذج GLM.

Q02ما هو أرخص نموذج GLM-5 يمكن استدعاؤه؟

GLM-5.3 Flash. يكلف على OpenRouter ما قيمته $0.0052 لكل مليون توكن إدخال و$0.1985 لكل مليون توكن إخراج، كما يمكنه أيضًا قراءة الصور والفيديو.

Q03ما هي معرّفات نماذج GLM-5.3؟

على OpenRouter: z-ai/glm-5.3، وz-ai/glm-5.3-flash، وz-ai/glm-5.3-flashx، وz-ai/glm-5.3-prime. وعلى منصة Z.ai: glm-5.3، وglm-5.3-flash، وglm-5.3-flashx.

Q04هل يمكنني إيقاف التفكير المنطقي؟

يستخدم GLM-5.3 التفكير المنطقي دائمًا على منصة Z.ai. يمكنك تقصيره بطلب جهد تفكير منخفض، وهو ما تفعله محادثتنا المجانية افتراضيًا.

Q05هل يتوفر API مجاني لـ GLM-5؟

لا يقدم هذا الموقع API عامًا. يمكنك تجربة GLM-5.3 وGLM-5.3 Flash مجانًا في محادثتنا على الويب، ثم الانتقال إلى Z.ai أو OpenRouter للوصول البرمجي.

جرّبه الآن

اطرح على GLM-5.3 سؤالاً واقعياً.

بدون حساب، بدون بطاقة، وبدون تثبيت. اكتب سؤالك وشاهد GLM-5.3 Flash يجيبك في ثوانٍ — وانتقل إلى GLM-5.3 للمهام الأكثر صعوبة وتعقيداً.

افتح المحادثة المجانيةتُطبّق حدود يومية مجانية لضمان إتاحة المحادثة للجميع.