البدء السريع: استخدم مفتاح واجهة برمجة التطبيقات الخاص بـ groq

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

تستبدل groq key API نقطة النهاية القياسية لـ OpenAI بمسار مباشر إلى نموذجنا غير الخاضع للرقابة. اضبط base_url إلى HTTPS://api.groqkeyapi.com/v1 وأدرج مفتاحك في Authorization الرأس. يعمل هذا التكوين مع أي عميل متوافق مع OpenAI، بما في ذلك مكتلات SDK الرسمية لـ Python و Node. لا تحتاج إلى تعديل اسم النموذج في الكود الخاص بك؛ نحن نتولى التوجيه داخليًا.

Copycurl https://api.groqkeyapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if endpoint supports 32k context window"}]
  }'

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

طلب إكمال المحادثة الأول

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

Copyfrom openai import OpenAI

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

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

فعّل التدفق للمخرجات في الوقت الفعلي

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

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)

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

استخدم وضع JSON للبيانات المهيكلة

تعيين response_format إلى {"type": "json_object"} لإجبار إخراج JSON الصارم. هذا مفيد للتكاملات البرمجية حيث تحتاج إلى هياكل بيانات قابلة للتنبؤ. سيحاول النموذج تنسيق الاستجابة كـ JSON صالح. قد يفشل إذا كان النص التوجيهي معقداً جداً أو تجاوزت المخرجات الحدود. تحقق دائماً من صحة JSON على جانب العميل.

Copyimport OpenAI from "openai";

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

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

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

تفرض الـ API حدًا قدره 300 طلب في الدقيقة لكل مفتاح. يمكنك تشغيل 8 طلبات متزامنة في وقت واحد. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. يشير خطأ 429 إلى تجاوزك لهذه الحدود. انتظر بضع ثوانٍ وأعد المحاولة. يعني الخطأ 402 استنفاد رصيدك المدفوع مسبقاً. قم بشحن الرصيد عبر العملات المشفرة لاستئناف الخدمة. الأخطاء مثل 400 أو 500 لا تستهلك الرصيد.

معرف النموذج هو دائماً "uncensored". لا تحاول تبديل النماذج. نستضيف نموذج لغة كبيراً واحداً محسناً للمحتوى غير المقيد. هذا يبسط البنية السريعة والسريعة.

نافذة السياق وحدود الرموز

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

لا يؤثر وضع JSON والبث على هذه الحدود. تظل متسقة عبر جميع أنواع الطلبات. استخدم usage field في الاستجابة لتتبع استهلاكك بدقة.