عنوان URL الأساسي والمصادقة
استخدم عنوان URL الأساسي ومفتاح API المقدمين لربط العميل الخاص بك. نقطة النهاية هي https://api.qwencodeapikey.com/v1. يجب أن تتضمن مفتاحك في Authorization الرأس من كل طلب. يضمن هذا أن تحدد الخدمة حساب الرصيد المدفوع مسبقاً الخاص بك بشكل صحيح.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
يمكنك إنشاء مفتاح عبر Google أو البريد الإلكتروني في صفحة التسجيل. يظهر المفتاح فوراً. احفظه بأمان، فهو يتحكم في إنفاقك.
نقطة نهاية إكمال الدردشة
أرسل الرسائل إلى /v1/chat/completions نقطة النهاية للحصول على استجابات نصية. هذه هي الواجهة القياسية لمعظم مكتبات OpenAI. أنت تحدد model كـ uncensored وتوفير قائمة بالرسائل في messages مصفوفة. تعالج واجهة برمجة التطبيقات مدخلاتك وتعيد إكمالًا مُولّدًا.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
تأكد من أن مكتبة العميل الخاصة بك تشير إلى عنوان URL الأساسي الصحيح. معرف النموذج uncensored يُفعّل النموذج مفتوح الوزن المُضبط على رفض أقل. يتعامل مع أدوار المحادثة مثل أي واجهة برمجة تطبيقات دردشة أخرى.
Models Endpoint
استعلام GET /v1/models للتحقق من النماذج المتاحة وتفاصيلها. تُعيد هذه النقطة النهائية قائمة بالنماذج المتاحة لمفتاحك. يساعدك هذا في تأكيد ال uncensored النموذج نشط وجاهز للطلبات. استخدم هذا لتصكوينات العميل قبل إرسال حمولات كاملة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
تحقق من بنية الاستجابة لضمان قيام SDK الخاص بك بتحليل قائمة النماذج بشكل صحيح. لا يستهلك هذا الطرف رصيداً، مما يجعله آمناً لفحوصات التهيئة.
معاملات الطلب والتدفق
يدعم المعايير القياسية مثل temperature, top_p, stop، و seed. مكن البث عن طريق تعيين stream: true. تُرسل الـ API الرموز عبر أحداث الإرسال من الخادم (SSE). تظهر إحصائيات استخدام الرموز في الجزء الأخير من التدفق. يتيح هذا العرض الفوري للنص المُولّد.
stream = 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)
تعيين max_tokens للتحكم في طول المخرجات. القيمة الافتراضية هي 2,048 رمزاً. يمكنك زيادة هذا الحد إلى 16,000 رمز لكل طلب. اضبط المعلمات لتحقيق التوازن بين الإبداع والدقة في استجاباتك.
حدود المعدلات والقيود
يتيح كل مفتاح 300 طلب في الدقيقة و8 طلبات متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تمنع هذه الحدود سوء الاستخدام وتضمن أداءً مستقراً. إذا تجاوزت المعدل، تتلقى خطأ 429. عدّل منطق العميل الخاص بك للتعامل مع إعادة المحاولة باستخدام زيادة الأثر الأسي.
تدعم نافذة السياق إجمالي 100,000 رمز. هذا يشمل النص المطلوب والإكمال. تتطلب السياقات الكبيرة إدارة دقيقة للرموز للبقاء ضمن الحدود.
وضع JSON واستدعاء الوظائف
استخدام response_format: {"type": "json_object"} لمخرجات مُهيّأة. يضمن هذا أن يُرجع النموذج JSON صالحًا، وهو مفيد للتكامل البرمجي. يعمل استدعاء الوظائف عبر tools معامل. عرّف الأدوات بتنسيق OpenAI القياسي. سيقوم النموذج باستدعاء الوظائف عند الحاجة.
الأخطاء والرفض لا يستهلكان رصيدًا. ينطبق هذا حتى إذا رفض النموذج طلبًا بسبب حد المحتوى الصارم. تدفع فقط مقابل استخدام الرموز الفعلي. الرصيد لا ينتهي صلاحيته أبدًا، لذا يمكنك الشحن عندما يناسبك.
معالجة الأخطاء والاستخدام
التعامل مع أخطاء HTTP بشكل أنيق. يشير خطأ 401 إلى مفتاح API غير صالح أو منتهي الصلاحية. يعني خطأ 402 أن رصيدك المدفوع مسبقاً قد استُنفد. يشير خطأ 429 إلى تجاوز حد معدل الطلب. تحقق من جسم الاستجابة للحصول على رسائل خطأ مفصلة.
يتم تتبع الاستخدام لكل مفتاح. مفتاح نشط واحد لكل حساب يبسط الفواتير. إذا ارتكبت خطأً، مثل الشحن المزدوج، استخدم صفحة الدعم. لا يتم استرداد الرصيد لكنه يظل صالحًا. الأخطاء مجانية، لذا لا تستنزف الطلبات الفاشلة رصيدك.
الملخص وأفضل الممارسات
ابدأ بعنوان URL الأساسي ومفتاح صالح. استخدم ال uncensored معرف النموذج لرفض أقل. قم بتدفق الاستجابات لتحسين تجربة المستخدم. راقب حدود معدل الطلب لتجنب الانقطاعات. استخدم وضع JSON للبيانات المهيكلة. تعامل مع الأخطاء للحفاظ على الموثوقية. الرصيد مسبق ولا ينتهي. قم بالشحن بالعملات المشفرة عند الحاجة. تتناسب هذه واجهة برمجة التطبيقات (API) بسلاسة مع قواعد الشيفرة الحالية لـ OpenAI. لا حاجة إلى مكتبات SDK جديدة. فقط غيّر عنوان URL الأساسي والمفتاح.
