البدء السريع لمستخدمي GLM

التثبيت والإعداد

للبدء، تأكد من تثبيت SDK الرسمي الخاص بـ OpenAI للغة التي تستخدمها. تستخدم واجهة برمجة التطبيقات مصادقة قياسية تعتمد على الرؤوس. يجب عليك تعيين رأس Authorization إلى Bearer your-api-key وتكوين عنوان URL الأساسي إلى https://api.glmapi.cc/v1. يعمل هذا العنوان مع أي عميل يدعم تنسيق Chat Completions الخاص بـ OpenAI.

لا يلزم تهيئة عميل خاصة تتجاوز التكوين القياسي. تعمل الخدمة كبديل جاهز للاستخدام للتكاملات الحالية مع OpenAI. يمكنك التحقق من إعدادك عن طريق التحقق من نقطة النهاية الخاصة بالنماذج المتاحة.

الطلب الأول

أرسل طلب إكمال نصي بسيط لاختبار الاتصال. استخدم معرف النموذج uncensored للنموذج اللغوي الكبير الأساسي. تقبل واجهة برمجة التطبيقات المعايير القياسية مثل max_tokens و temperature.

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

نسخcurl https://api.glmapi.cc/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."}]
  }'

تكامل SDK الخاص بـ Python

استخدم المكتبة الرسمية لـ Python للتفاعل مع واجهة برمجة التطبيقات. قم بتهيئة العميل باستخدام عنوان URL الأساسي ومفتاح API الخاص بك. يتطابق التركيب مع هيكل العميل القياسي لـ OpenAI.

تتيح لك هذه الطريقة تبديل المزودين دون إعادة كتابة منطق الأعمال. يستجيب النموذج لتنسيقات الموجّه القياسية. يمكنك التحكم في طول الإخراج والعشوائية عبر المعايير القياسية.

نسخfrom openai import OpenAI

client = OpenAI(base_url="https://api.glmapi.cc/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)

تكامل SDK الخاص بـ Node.js

لبيئات JavaScript، استخدم SDK الخاص بـ Node.js. قم بتكوين baseUrl للإشارة إلى نقطة النهاية الخاصة بواجهتنا. يضمن ذلك توجيه جميع الطلبات بشكل صحيح إلى خوادمنا.

يتعامل SDK مع إعادة المحاولة وتحليل الاستجابة تلقائيًا. يمكنك تمرير معايير الإكمال القياسية. يحتوي كائن الاستجابة على النص المولد في الموقع المتوقع.

نسخimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapi.cc/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);

استجابات البث المتدفق

فعّل البث المتدفق عن طريق تعيين المعلمة stream إلى true. تعيد واجهة برمجة التطبيقات أجزاء عبر أحداث Server-Sent Events (SSE). يحتوي كل جزء على نص جزئي وإحصائيات الاستخدام.

تقلل هذه الطريقة من زمن الاستجابة المدرك للاستجابات الطويلة. يمكنك معالجة الرموز عند وصولها. يتضمن الجزء الأخير إجمالي عدد الرموز للفوترة.

نسخstream = 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)

الحدود والأخطاء والسياق

يدعم نافذة السياق 100,000 رمز إجمالاً، مع حد أقصى للإخراج هو 32,000 رمز. ستفشل الطلبات التي تتجاوز حد حجم الجسم البالغ 8 ميجابايت. أنت مقيد بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح.

يعني الخطأ 401 مفتاح غير صالح. يشير الخطأ 402 إلى عدم بقاء رصيد مسبق الدفع. يشير الخطأ 429 إلى حدّ المعدل. الرصيد لا ينتهي، والأخطاء لا تستهلك الرموز. الخصوصية محفوظة؛ لا تُستخدم الموجّهات للتدريب.