توثيق واجهة برمجة التطبيقات

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

ابدأ بإنشاء بيانات الاعتماد الخاصة بك على احصل على مفتاح API صفحة باستخدام Google أو البريد الإلكتروني. يعرض النظام مفتاحك على الفور، ويمكنك استبداله في أي وقت لإلغاء الوصول. جميع الطلبات تستهدف الواجهة القياسية /v1 بنية نقطة النهاية. لا تحتاج إلى تكوين رؤوس معقدة، فقط مرر المفتاح في رأس Authorization.

يعمل مفتاح API الخاص بنا للذكاء الاصطناعي غير الخاضع للرقابة مع أي مكتبة تدعم العملاء المتوافقين مع OpenAI. غيّر عنوان URL الأساسي إلى HTTPS://api.glmkey.com/v1 وأدرج رمزك. يعكس هذا الإعداد التكاملات القياسية، مما يضمن توجيه الكود الموجود لديك بشكل صحيح دون حبس البائع.

• عنوان URL الأساسي: HTTPS://api.glmkey.com/v1
• رأس المصادقة: Authorization: Bearer YOUR_API_KEY

مرجع نقطة نهاية إكمال الدردشة

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

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

Copycurl https://api.glmkey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the endpoints for the glm key service"}]
  }'

تكامل مكتبة Python

ثبّت الحزمة الرسمية من OpenAI وقم بتكوينها لتشير إلى عنوان URL الأساسي الخاص بنا. يتيح لك ذلك استخدام أنماط بايثون المألوفة لتوليد النص. يتعامل العميل مع التسلسل وإعادة المحاولة تلقائيًا. يمكنك تمرير معلمات مثل temperature أو top_p للتحكم في الإبداع.

يقبل LLM غير الخاضع للرقونة تنسيقات الرسائل القياسية. يمكنك التبديل بين أدوار النظام والمستخدم والمساعد تمامًا كما تفعل مع أي مزود آخر. يوضح مقتطف Python التالي طلب إكمال أساسي.

Copyfrom openai import OpenAI

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

استخدم حزمة Node.js لإدراج مفتاح API في مشاريع JavaScript أو TypeScript الخاصة بك. اضبط apiKey و baseURL الخصائص في تكوين العميل. يضمن ذلك توجيه جميع الطلبات إلى خوادمنا بدلاً من المزود الافتراضي. يمكنك بعد ذلك استدعاء chat.completions.create() مع المعلمات المطلوبة.

تدعم واجهة برمجة التطبيقات غير الخاضعة للرقابة تعريفات الأدوات القياسية وأوضاع JSON. يمكنك تحليل الاستجابات مباشرة في منطق تطبيقك. يوضح مثال Node.js التالي كيفية تهيئة العميل وإرسال رسالة بسيطة.

Copyimport OpenAI from "openai";

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

الاستجابات التدفقية وأعداد الرموز

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

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

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)

قواعد حدود المعدلات والتزامن

يُسمح لك بإرسال 300 طلبًا في الدقيقة لكل مفتاح. يتم تحديد التزامن بحد أقصى 8 طلبات متزامنة. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. تضمن هذه الحدود أداءً مستقرًا لجميع المستخدمين المدفوعين مسبقًا. إذا تجاوزت المعدل، ستتلقى خطأ 429.

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