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

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

API الخاص بنا متوافق تمامًا مع OpenAI SDKs. تحتاج فقط إلى تحديث base_url وتزويد مفتاحك في رأس Authorization. سجّل الدخول عبر Google أو البريد الإلكتروني للحصول على مفتاحك فورًا. لا يتطلب رقم هاتف أو بطاقة ائتمان للبدء. استخدم معرف النموذج uncensored لجميع الطلبات.

تتم المصادقة باستخدام رموز Bearer. تأكد من إرسال مفتاحك في رأس كل طلب. إذا تلقيت خطأ 401، فإن مفتاحك غير صالح أو منتهي الصلاحية. خدمتنا مستقلة ولا تعيد بيع نماذج موردين آخرين.

إكمال الدردشة الأساسي

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

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

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

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

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

استدعاء الدوال

حدد الأدوات في المعلمة tools. يمكن للنموذج إرجاع استدعاءات أدوات منظمة. استخدم tool_choice لفرض سلوكيات محددة. هذا يتيح التكامل مع الأنظمة الخارجية وسير العمل.

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

وضع JSON

عيّن response_format إلى {"type": "json_object"} لإخراج JSON صارم. سيقوم النموذج بتنسيق استجابته كـ JSON صالح. هذا مفيد لتحليل البيانات المنظمة في التطبيقات.

يضمن وضع JSON تنسيقًا متسقًا. استخدمه عندما يتوقع رمزك التالي هياكل مخطط محددة. يلتزم النموذج بالتنسيق المطلوب. هذا يقلل من الحاجة إلى منطق تحليل إضافي.

المعلمات والحدود والأخطاء

تحكم في التوليد باستخدام temperature، top_p، وتسلسلات stop. حدّ المعدل هو 300 طلب في الدقيقة لكل مفتاح. يمكنك إجراء ما يصل إلى 8 طلبات متزامنة. يجب ألا تتجاوز أحمال الطلب 8 MB. يشير خطأ 402 إلى عدم كفاية الرصيد. يعني خطأ 429 أنك تجاوزت حدّ المعدل. الرصيد مسبق الدفع ولا ينتهي. الأخطاء مجانية.

cURL

Copycurl https://api.grokuncensored.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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

البث المتدفق

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)