عنوان URL الأساسي والمصادقة
يتبع API الخاص بنا معيار OpenAI Chat Completions. للتفاعل مع الخدمة، يجب توجيه عميلك إلى https://api.grokapikey.com/v1 وإدراج مفتاح API الفريد الخاص بك في رأس Authorization. يمكنك إنشاء هذا المفتاح فورًا بعد إنشاء حسابك باستخدام البريد الإلكتروني وكلمة المرور فقط. يظهر المفتاح مرة واحدة عند إنشائه، لذا احفظه بأمان. إذا فقدته، يمكنك إنشاء مفتاح جديد من لوحة التحكم، مما يلغي سريان المفتاح السابق فورًا. لا حاجة لربط بطاقة ائتمان لحساب التجربة.
طلبك الأول
ابدأ بإرسال موجّه نصي بسيط للتحقق من الاتصال. استخدم نقطة النهاية القياسية chat/completions مع معرف النموذج uncensored. يوضح المثال التالي أمر curl أساسي لاختبار الاتصال. يؤكد هذا أن مصادقتك صحيحة وأن الخدمة تستجيب. يمكنك بعد ذلك تكييف هذا الهيكل لمنطق التطبيق الخاص بك.
استبدل YOUR_API_KEY بمفتاحك الفعلي قبل تشغيل هذا الأمر.
curl https://api.grokapikey.com/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، استخدم المكتبة الرسمية openai. قم بتكوين العميل لاستخدام عنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. هذا يتيح لك الاستفادة من العادات المألوفة في Python مع الوصول إلى النموذج غير الخاضع للرقابة. يتعامل العميل مع التسلسل والتدفق تلقائيًا. تأكد من أن بيئتك تحتوي على أحدث إصدار من المكتبة لأفضل توافق مع نقاط النهاية الخاصة بنا.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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)تكامل SDK لـ Node.js
لمشاريع JavaScript أو TypeScript، يعمل Node.js OpenAI SDK بشكل مباشر. اضبط خصائص apiKey و baseURL في كائن التكوين الخاص بك. يضمن هذا توجيه جميع الطلبات اللاحقة عبر البنية التحتية الخاصة بنا. يمكنك استخدام أنماط async/await القياسية للتعامل مع الاستجابات. هذا النهج مثالي لتطبيقات الخادم أو الوظائف الطرفية التي تتطلب وصولاً مباشرًا إلى API دون التوجيه عبر OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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) للاستجابات الجزئية. يقلل هذا من زمن الاستجابة المدرك للمستخدمين ويسمح بعرض النص المولّد فورًا. يحتوي كل جزء على فرق الاستجابة. تعامل مع هذه الأحداث في رمز العميل لتحديث واجهة المستخدم تدريجيًا. يستهلك البث المتدفق الرموز بشكل طبيعي ولا يؤثر على التسعير.
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)الحدود والأخطاء والنافذة السياقية
يُقتصر كل مفتاح API على 300 طلب في الدقيقة وحجم جسم طلب أقصى يبلغ 8 MB. إذا تجاوزت حدّ المعدل، تُرجع الواجهة رمز حالة 429؛ انتظر بضع ثوانٍ وأعد المحاولة. يشير الخطأ 401 إلى مفتاح غير صالح أو ملغي، بينما يعني الخطأ 402 استنفاد رصيدك المسبق الدفع. يدعم النموذج نافذة سياق بحجم 100,000 رمز لكل من الإدخال والإخراج معًا. تأكد من أن الموجّهات تتسع ضمن هذا الحد لتجنب الاقتطاع. تبقى فلاتر المحتوى ضئيلة، باستثناء حظر صارم على المحتوى الجنسي الذي يتضمن قاصرين.
