ar ▾
فتح الحساب

توثيق واجهة برمجة التطبيقات & بداية سريعة

ابدأ باستخدام واجهة برمجة التطبيقات (API) لنموذج اللغة الكبيرة (LLM) غير المقيد في دقائق. يغطي هذا الدليل نقطة النهاية المتوافقة مع OpenAI، والمصادقة، وأنماط التكامل الأساسية للمطورين.

عنوان URL الأساسي والمصادقة

استخدام https://api.glmdocs.com/v1 كعنوان URL الأساسي. مرر مفتاح API الخاص بك في Authorization: Bearer الرأس. تحصل على مفتاح فورًا بعد التسجيل. لا يلزم رقم هاتف. المفتاح فريد لكل حساب. استبدل المفتاح القديم عند إنشاء مفتاح جديد. احفظ مفتاحك بأمان.

curl https://api.glmdocs.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Explain how to parse JSON in Python"}]
  }'

المصادقة قياسية. أي حزمة SDK من OpenAI تعمل هنا. غيّر عنوان URL الأساسي. اضبط مفتاح API. هذا كل ما تحتاج إلى فعله. الأخطاء تُرجع أكواد HTTP قياسية. استخدم 401 للمفاتيح غير الصالحة. استخدم 402 لعدم كفاية الرصيد.

الطلب الأول باستخدام Python

أرسل أول موجه باستخدام حزمة SDK الرسمية لـ Python. قم بتثبيت الحزمة. حدد عنوان URL الأساسي. قم باستيراد العميل. استدعِ إكمال الدردشة. معرف النموذج هو "uncensored". يتعامل مع النص كإدخال وخرج. لا حاجة لإعداد إضافي. تحتوي الاستجابة على النص المولد.

from openai import OpenAI

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

قم بالتكامل مع Node.js باستخدام العميل القياسي. حدد متغير البيئة. قم بتهيئة العميل. اطلب الإكمال. تعامل مع الاستجابة. الرمز مباشر. استخدم نفس معرف النموذج. تتولى الحزمة التسلسل. تحصل على بيانات منظمة.

import OpenAI from "openai";

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

يحصل مستخدمو Node.js على نفس زمن الوصول. واجهة برمجة التطبيقات متزامنة بشكل افتراضي. يتطلب التدفق تكوينًا إضافيًا. معالجة الأخطاء أمر بالغ الأهمية. التقط مشكلات الشبكة. تحقق من حدود المعدل. يظل عنوان URL الأساسي ثابتًا. يظل مفتاحك كما هو.

استجابات البث

فعّل التدفق للمخرجات في الوقت الفعلي. اضبط علم التدفق. استلم القطع أثناء توليدها. تتضمن القطعة الأخيرة استخدام الرموز. يساعد ذلك في تتبع التكاليف. يدعم 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)

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

استدعاء الوظائف ووضع JSON

استخدم استدعاء الوظائف للمخرجات المنظمة. عرّف أدواتك في الطلب. يعيد النموذج JSON صالح. مكن وضع JSON للمخرجات الصارمة. اضبط response_format إلى json_object. تتحكم درجة الحرارة في العشوائية. تحد Top_p من التنوع. توقف تسلسلات التوليد. يضمن البذرة إمكانية الاستنساخ.

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

حدود المعدلات والسياق

حدود معدل الطلبات هي 300 طلب في الدقيقة. الطلبات المتزامنة محدودة بـ 8. يجب أن تبقى أحجام أجسام الطلبات أقل من 8 ميجابايت. نافذة السياق هي 100,000 رمز. هذا يشمل الطلب والإكمال. الحد الأقصى للإخراج هو 16,000 رمز. الإخراج الافتراضي هو 2,048 رمز. اضبط max_tokens لتمديد هذا.

تعيد الأخطاء رموزاً واضحة. تعني 401 مفتاحاً غير صالح. تعني 402 عدم وجود رصيد. تعني 429 حد معدل الطلبات. تحقق من الاستخدام في لوحة التحكم. لا تنتهي صلاحية الرصيد. يغطي الرصيد المدفوع مسبقاً جميع المكالمات. فقط العملات المشفرة للإضافة. USDT أو USDC.

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

ما هو عنوان URL الأساسي لواجهة برمجة التطبيقات (API) لوثائق GLM؟

عنوان URL الأساسي هو HTTPS://api.glmdocs.com/v1. يعمل مع أي مكتبة متوافقة مع OpenAI. تحتاج فقط إلى تغيير عنوان URL الأساسي وتعيين مفتاح API الخاص بك.

كمية السياق التي يدعمها النموذج غير الخاضع للرقابة؟

يدعم النموذج نافذة سياق تتكون من 100,000 رمز. يشمل هذا كل من تعليمات الإدخال والتكميل المُولّد. الحد الأقصى للإخراج في كل طلب هو 16,000 رمز.

ماذا يحدث إذا تجاوزت حد معدل الطلب؟

ستتلقى رمز الحالة 429. الحد هو 300 طلب في الدقيقة و8 طلبات متزامنة. انتظر لحظة وأعد المحاولة. تم تصميم واجهة برمجة التطبيقات للاستخدام عالي الإنتاجية.

يبدأ الوصول بنموذج

سجّل، احصل على الرمز، حدّث عنوان URL الأساسي. بسيط.