GLM API: غيّر عميلك في ثلاثة أسطر

المتطلبات المسبقة: احصل على مفتاحك

قبل كتابة الكود، تحتاج إلى مفتاح API. قم بزيارة صفحة Get API key في هذا الموقع لتسجيل حساب باستخدام البريد الإلكتروني وكلمة المرور. لا يتطلب البدء رقم هاتف أو بطاقة ائتمان. عند التسجيل، تحصل على رصيد تجريبي مجاني بقيمة $0.50 صالح لمدة 7 أيام، أو يمكنك الشحن بالعملات المشفرة (USDT أو USDC). يتم عرض مفتاحك فورًا بعد التسجيل. احفظه بأمان، حيث يمكنك إعادة توليده في أي وقت لإلغاء المفتاح القديم.

يصادق هذا المفتاح على جميع الطلبات المرسلة إلى نقطة النهاية glm api. لا نستخدم الموجّهات الخاصة بك للتدريب، والمفتاح مرتبط بحساب واحد. إذا كنت بحاجة إلى حجم طلبات أعلى، يمكنك شراء رصيد مسبق الدفع لا ينتهي صلاحيته أبدًا.

تكوين نقطة الأساس والمفتاح

لاستخدام خدمتنا كبديل جاهز للاستخدام لـ OpenAI، يجب أن تشير إلى نقطة الأساس الخاصة بنا. هذا هو تغيير البنية التحتية الوحيد المطلوب. نقطة الأساس هي https://api.glmapikey.com/v1. تحتاج أيضًا إلى تعيين رأس المصادقة أو مفتاح عميل SDK إلى القيمة التي تلقيتها أثناء التسجيل.

تسمح معظم العملاء المتوافقين مع OpenAI، بما في ذلك SDKs الرسمية لـ Python وNode.js، بتجاوز نقطة الأساس. هذا يسمح لك بالاحتفاظ بمنطق التطبيق الحالي مع تبديل النموذج الأساسي. تأكد من ضبط مفتاحك بشكل صحيح قبل إرسال الطلبات لتجنب أخطاء المصادقة.

أرسل طلب إكمال الدردشة الأول

أرسل طلب POST إلى /v1/chat/completions لتوليد النص. يقبل النموذج الخاص بنا هياكل الرسائل القياسية مع أدوار مثل user وassistant. معرف النموذج الذي يجب تحديده هو uncensored. هذا يُفعّل نموذج مفتوح الأوزان مستضاف على وحدات GPU الخاصة بنا، وهو مُعدّ للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين.

سيكون الرد بصيغة JSON يحتوي على النص المُولّد. إذا واجهت خطأ 401، تحقق من مفتاحك. إذا رأيت خطأ 402، فهذا يعني أن رصيدك المسبق الدفع قد استُنفد. يمكنك الشحن بدءًا من $10. لاحظ أننا لا ندعم التضمينات (embeddings) أو الصور أو ضبط الدقة في هذه نقطة النهاية.

استخدام SDK Python

مكتبة Python الرسمية لـ OpenAI تعمل مباشرة مع API الخاص بنا. قم بتهيئة العميل بمفتاحك ونقطة الأساس المحددة. هذا النهج مثالي لخدمات الخلفية أو السكربتات حيث تحتاج إلى استجابات JSON منظمة. يتعامل العميل مع التسلسل المنطقي ومنطق إعادة المحاولة تلقائيًا.

مرر اسم النموذج uncensored للتأكد من أنك تصل إلى نقطة النهاية الخاصة بنا. تدعم نافذة السياق ما يصل إلى 100,000 رمز (token) للموجّه والإكمال معًا. هذا يسمح ببيانات إدخال كبيرة دون اقتطاع، بشرط أن تظل ضمن حد حجم جسم الطلب البالغ 8 MB.

استخدام SDK Node.js

لتطبيقات JavaScript و TypeScript، حزمة NPM openai متوافقة. قم بتكوين العميل بنفس عنوان URL الأساسي والمفتاح كما في مثال Python. هذا يتيح عرض الخادم أو نقاط النهاية التي تتطلب توليد نص بدون رقابة. يقوم SDK ببث البيانات بكفاءة إذا تم تكوينه بشكل صحيح.

استدعاء الدوال مدعوم في هذا SDK. يمكنك تعريف مخططات الوظائف في الطلب، وسيعيد النموذج مخرجات JSON منظمة تتطابق مع مخططك. هذا يجعل من السهل دمج مصادر البيانات الخارجية أو الإجراءات في تدفق تطبيقك دون تحليل النص الخام.

تمكين استجابات البث المتدفق

قم بتعيين stream: true في طلبك لتلقي أحداث المرسلة من الخادم (SSE). هذا يسمح لك بعرض النص للمستخدمين أثناء توليده، مما يحسن زمن الاستجابة المُدرَك. تُرجع واجهة API أجزاء من النص، ويجب على عميلك تجميعها أو عرضها تدريجيًا.

البث المتدفق مدعوم لكل من SDKs Python وNode.js. إنه مفيد بشكل خاص لواجهات الدردشة حيث يتوقع المستخدمون ردود فعل فورية. يحتوي كل جزء على جزء من الاستجابة. يستمر النموذج في التوليد حتى يكمل أو يصل إلى حد نافذة السياق. تأكد من أن عميلك يتعامل مع هياكل JSON الجزئية بشكل صحيح إذا كنت تستخدم استدعاء الدوال مع البث.

الحدود، الأخطاء، والنماذج

تفرض واجهة API لدينا حدّ معدل قدره 300 طلب في الدقيقة لكل مفتاح. إذا تجاوزت هذا الحد، ستتلقى خطأ 429. الحد الأقصى لحجم جسم الطلب هو 8 MB. لاكتشاف النماذج، استخدم نقطة النهاية GET /v1/models. تُرجع قائمة بالنماذج المتاحة، بما في ذلك معرف النموذج uncensored.

تشمل الأخطاء الشائعة خطأ 401 للمفاتيح غير الصالحة وخطأ 402 لعدم كفاية الرصيد. لا تنتهي صلاحية الرصيد، لكن رصيد التجربة صالح لمدة 7 أيام. لا نقدم اتفاقيات مستوى الخدمة أو الشهادات. يمنع النموذج المحتوى الجنسي الذي يتضمن قاصرين، لكنه بدون رقابة بخلاف ذلك. استخدم هذه الحدود لتصميم منطق إعادة المحاكمة وإشعارات المستخدم بشكل مناسب.

cURL

Copycurl https://api.glmapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.glmapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

البث المتدفق

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)