وثائق واجهة برمجة التطبيقات API queen

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

تعتمد المصادقة على رمز حامل قياسي يُمرر في Authorization الرأس. يضمن هذا النهج التوافق مع مكتلات SDK الحالية لـ OpenAI دون الحاجة إلى منطق مخصص. عميلك API_KEY يتم توليده فوراً عند التسجيل عبر Google أو البريد الإلكتروني. يجب أن تشير جميع الطلبات إلى عنوان URL الأساسي المحدد المقدم للخدمة.

• URL الأساسي: https://api.apiqueen.cc/v1
• رأس: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

إرسال الطلبات إلى /v1/chat/completions

أرسل بيانات نصية إلى نقطة النهاية للحصول على استجابات النموذج المباشرة. معرف النموذج هو دائماً uncensored, والذي يتناول مواضيع متنوعة دون الرفض القياسي. يمكنك تحديد معلمات مثل temperature و top_p للتحكم في الإبداع. يتوقع النظام قائمة بالرسائل بالتنسيق القياسي للمحادثات.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

معلمات النموذج: درجة الحرارة، Top-P، وStop

تحكم في توليد الاستجابة باستخدام معاملات LLM القياسية. اضبط temperature بين 0 و2 لتفاوت العشوائية. استخدم top_p لتصفية الكلمات منخفضة الاحتمال. عرّف stop تسلسلات لإيقاف المخرجات عند محفزات محددة. تتيح هذه الإعدادات ضبطاً دقيقاً لمهام الكتابة الإبداعية أو استرجاع الحقائق.

تتجاهل واجهة برمجة التطبيقات (API) المعلمات غير المدعومة بلطف. ركز على temperature, top_p، و stop للنتائج الدقيقة. اضبط هذه القيم بناءً على تحمل الضوضاء في تطبيقك.

استجابات البث واستهلاك الرموز

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد الـ API كتل بيانات عبر أحداث الإرسال من الخادم (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

استخدم استدعاء الوظائف لاستخراج البيانات المنظمة. عرّف الأدوات في tools معامل. يعيد النموذج JSON صالح عندما response_format مضبوط على {"type": "json_object"}. هذا يضمن تحليلًا متسقًا في التطبيقات اللاحقة.

تعيين tool_choice لإجبار استدعاءات وظائف محددة. هذا مفيد لعمليات العمل الآلية التي تتطلب تنسيقات إخراج صارمة.

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

راقب رموز حالة HTTP للأخطاء الشائعة. يعني الخطأ 401 أن مفتاح API الخاص بك غير صالح. يشير الخطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. لا تستهلك الأخطاء رصيد الرمز الخاص بك. تفرض حدود المعدل 300 طلب في الدقيقة لكل مفتاح. يتم تحديد الطلبات المتزامنة بـ 8. يدعم نافذة السياق 100,000 رمز إجمالاً.

تعامل مع عمليات إعادة المحاولة باستخدام زيادة أسيّة. تحقق من error كائن في استجابات JSON للتفاصيل.