توثيق واجهة برمجة تطبيقات إكمال الدردشة غير الخاضعة للرقان

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

ابدأ كل طلب بتوجيه مكتبة (SDK) الخاصة بك إلى عنوان URL الأساسي الخاص بنا وإرفاق مفتاحك. نستخدم مصادقة الرؤوس القياسية، لذا فإن العملاء الحاليين يعملون دون تعديل. يمنحك المفتاح الوصول إلى النموذج غير المقيد للمحتوى البالغ القانوني والأعمال الإبداعية غير المقيدة.

• URL الأساسي: https://api.grokaiapikey.com/v1
• رأس: Authorization: Bearer YOUR_API_KEY

أنشئ مفتاحك على الفور عبر تسجيل الدخول عبر Google أو البريد الإلكتروني. لا يتطلب رقم هاتف. المفتاح فريد لكل حساب، ويؤدي إنشاء مفتاح جديد إلى استبدال المفتاح النشط القديم على الفور.

الطلب الأول

أرسل أول إكمال (completion) باستخدام نقطة النهاية القياسية لإكمال الدردشة. يوضح هذا الطلب POST البسيط كيفية التفاعل مع النموذج لتوليد النص. يمكنك استبدال موجه النظام (system prompt) لتحديد الشخصية أو السلوك.

تأكد من أن جسم الطلب يتضمن model field مضبوطًا إلى uncensored. تُعيد الـ API استجابة JSON قياسية تحتوي على النص المُولّد وإحصائيات استخدام الرموز.

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

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI لدمج واجهة برمجة التطبيقات الخاصة بنا في مشاريعك. يتطلب هذا النهج تغييرات قليلة في الشفرة البرمجية إذا كنت تنتقل من مزودي خدمات آخرين. قم بتعيين عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا وقدم مفتاح واجهة برمجة التطبيقات الخاص بك.

يتعامل العميل مع المصادقة والتسلسل تلقائياً. يمكنك إرسال رسائل متعددة في السجل للحفاظ على السياق. هذه الطريقة مثالية لخدمات الخلفية وسير العمل النصي.

تكامل Node SDK

قم بتنفيذ واجهة برمجة التطبيقات في Node.js باستخدام حزمة OpenAI SDK القياسية. يعمل هذا الإعداد بسلاسة مع مشاريع JavaScript و TypeScript. قم بتكوين العميل بعنوان URL الأساسي الخاص بنا ومفتاحك السري.

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

استخدام الرموز والبث

تمكين التدفق لتوصيل الرمز للمستخدمين في الوقت الفعلي. يقلل هذه الميزة من زمن الاستجابة المُدرَك عن طريق إرسال البيانات أثناء توليدها. يتعامل مكتبة SDK مع تدفق الأحداث ويحدّ واجهة المستخدم تدريجيًا.

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

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

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

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

cURL

Copycurl https://api.grokaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten common unix commands with brief descriptions"}]
  }'

Python

Copyfrom openai import OpenAI

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