قم بدمج واجهة برمجة تطبيقات إكمال الدردشة غير المقيدة

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

ابدأ بإنشاء المفتاح الخاص بك عبر تسجيل الدخول باستخدام Google أو البريد الإلكتروني على صفحة "الحصول على مفتاح API". يصدر النظام مفتاحاً نشطاً واحداً لكل حساب فوراً، ويمكنك استبداله في أي وقت. استخدم عنوان URL الأساسي HTTPS://api.groqapikeys.com/v1 مع مفتاحك كرمز حامل. يعمل هذا التكوين مع أي عميل متوافق مع OpenAI دون خطوات وسيطة إضافية.

Copycurl https://api.groqapikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three advantages of low latency inference."}]
  }'

هيكل نقطة نهاية إكمال الدردشة

أرسل طلبات POST إلى /v1/chat/completions مع معرف النموذج الخاص بك كـ "uncensored". يقبل الطرف مصفوفات الرسائل القياسية ويعيد مخرجات نصية. لا نقدم التضميمات أو إنشاء الصور أو الضبط الدقيق. حافظ على حمولاتك أقل من 8 ميجابايت لضمان معالجة موثوقة. تُعاد الأخطاء مثل 401 (مفتاح غير صالح) أو 402 (عدم وجود رصيد) فورًا بحيث يمكنك تعديل التكامل الخاص بك.

الاستجابات التدفقية وعد الرموز

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

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)

تكوين استدعاء الأدوات ووضع JSON

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.groqapikeys.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 طلبات متزامنة. تمتد نافذة السياق عبر 100,000 رمز للإدخال والإكمال معاً. إذا تجاوزت هذه الحدود، يُرجح النظام خطأ حد معدل الطلبات 429. حافظ على أحجام طلباتك أقل من 8 ميجابايت لتأخير المعالجة. تضمن هذه الحدود أداءً مستقلاً لتطبيقات الإنتاجية العالية دون قيود طبقات مخفية.

معالجة الأخطاء وإعداد الاستخدام

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

Copyfrom openai import OpenAI

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