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

المتطلبات الأساسية: مفتاح API الخاص بك وعنوان URL الأساسي

ابدأ بإنشاء groq ai api key عبر صفحة الحصول على مفتاح API. يمكنك تسجيل الدخول باستخدام Google أو استخدام بريد إلكتروني وكلمة مرور لتلقي بيانات الاعتماد الخاصة بك فورًا. لا يتطلب هذا الإجراء رقم هاتف.

قم بتعيين عنوان URL الأساسي إلى https://api.groqaiapikey.com/v1 في تكوين العميل الخاص بك. تدعم هذه النقطة النهائية حزم تطوير البرامج (SDKs) القياسية الخاصة بـ OpenAI، مما يتيح لك تبديل المزودين دون إعادة كتابة منطق التكامل الخاص بك. تحتاج فقط إلى مفتاح نشط واحد لكل حساب، حيث يستبدل المفتاح الجديد المفتاح السابق فوراً.

الطلب الأول: إرسال طلب إلى /v1/chat/completions

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

تأكد من تعيين Content-Type الرأس بشكل صحيح لتجنب أخطاء 404 الشائعة. لا تدعم واجهة برمجة التطبيقات الخاصة بنا التضمينات (embeddings) أو توليد الصور أو معالجة الصوت، لذا ركّز حمولاتك على إكمالات الدردشة. يضمن هذا النهج المباشر أسعار رموز شفافة دون عبء وكيل متعدد البائعين.

ثبّت SDK: مكتبات متوافقة مع OpenAI

ثبّت حزمة بايثون الرسمية من OpenAI للتفاعل مع نقطة النهاية الخاصة بنا باستخدام أساليب مألوفة. تتعامل هذه المكتبة مع المصادقة وتسلسل JSON تلقائيًا عند توجيهها إلى عنوان URL الأساسي الخاص بنا. يمكنك استخدام نفس بنية الكود التي تستخدمها لـ GPT-4، ولكن مع نموذجنا غير الخاضع للرقابة.

للمطورين الذين يستخدمون JavaScript، قم بتثبيت openai حزمة Node.js. تتيح لك كلتا البيئتين تجاوز عنوان URL الأساسي بسهولة. يعني هذا التوافق أنه يمكنك التبديل بين مزودي LLM المختلفين عن طريق تغيير سطر تكوين واحد فقط في الكود الخاص بك.

التعامل مع التدفق: أحداث الإرسال من الخادم واستخدام الرمز

فعّل البث عن طريق تعيين stream: true في معاملات الطلب الخاص بك. تُعيد واجهة برمجة التطبيقات أحداث مُرسلة من الخادم (SSE) التي تسلّم الرموز تدريجياً أثناء توليدها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين الذين ينتظرون ردوداً طويلة.

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

معلمات متقدمة: درجة الحرارة، وضع JSON، والأدوات

استخدام temperature و top_p للتحكم في العشوائية والإبداع في استجاباتك. اضبط response_format إلى {"type": "json_object"} لإجبار إخراج JSON منظم لتحليل موثوق في تطبيقاتك. هذا ضروري لبناء واجهات برمجة تطبيقات روبوتات الدردشة NSFW القوية أو أدوات استخراج البيانات.

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

حدود، أخطاء، وتفاصيل الفوترة

تتوقع خطأ 401 إذا كان مفتاحك غير صالح، وخطأ 402 إذا كان لديك رصيد مدفوع مسبقاً غير كافٍ، وخطأ 429 إذا تجاوزت حد المعدل. أنت محدود بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب أن يبقى جسم الطلب أقل من 8 ميجابايت.

الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. الشحنات بالعملات المشفرة فقط (USDT على TRC20 أو USDC على Base) من $20 إلى $500. تحصل على مكافأة بنسبة 5% على $50، و10% على $100، و15% على $200. رصيدك المدفوع مسبقًا لا ينتهي، لذا يمكنك استخدامه عندما تحتاج إليه.

cURL

Copycurl https://api.groqaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit?"}]
  }'

Python

Copyfrom openai import OpenAI

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