البدء السريع لـ Groq api

المتطلبات الأساسية والتبعيات

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

تأكد من أن بيئتك تدعم حزم SDK الرسمية الخاصة بـ OpenAI. عنوان URL الأساسي الخاص بنا هو HTTPS://api.apigroq.com/v1. يعمل هذا مع أي عميل يقبل نقاط نهاية OpenAI القياسية. لا تحتاج إلى تثبيت برامج وسيطة إضافية.

مصادقة مفتاح groq API الخاص بك

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

• رأس: Authorization: Bearer YOUR_API_KEY
• لا تعرض مفاتيح API في كود الواجهة الأمامية.

إرسال أول إكمال لك

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

Copycurl https://api.apigroq.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies in requirements.txt"}]
  }'

يُرجف الرد النص فقط. لا يتم توليد التضميمات أو الصور. الأخطاء لا تستهلك رصيدك المدفوع مسبقًا.

معالجة استجابات التدفق

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

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)

يقلل هذا الأسلوب من زمن الاستجابة المُدرَك للردود الكبيرة. يجب على عميلك التعامل مع data: البادئة وتحليل كائنات JSON.

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

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apigroq.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 مع إعادة المحاولة وتحليل JSON تلقائياً. يمكنك أيضاً تفعيل وضع JSON عن طريق تعيين response_format إلى {"type": "json_object"}.

Node SDK والحدود

استخدم عميل Node.js OpenAI بشكل مشابه. اضبط عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا. راقب حدود معدل الطلب عن كثب.

Copyimport OpenAI from "openai";

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

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