تثبيت SDK الرسمي
ابدأ بتثبيت مكتبة OpenAI Python الرسمية في بيئة العمل الخاصة بك. تتعامل هذه المكتبة مع طلبات HTTP وتحويل البيانات إلى صيغة JSON نيابةً عنك.
- تشغيل
pip install openaiفي طرفية الأوامر. - تأكد من استخدام إصدار حديث من المكتبة.
يمنحك هذا الاعتماد الوحيد الوصول إلى واجهة العميل القياسية المستخدمة عبر الصناعة.
تكوين عنوان URL الأساسي والمفتاح
وجّه عميلك إلى عنوان URL الأساسي واضبط مفتاح واجهة برمجة التطبيقات (API) الخاص بك للمصادقة. يضمن هذا توجيه جميع الطلبات إلى خادم النموذج غير الخاضع للرقابة لدينا.
استخدام https://api.qwenmaxapi.com/v1 كعنوان URL الأساسي. قم بإنشاء مفتاحك على احصل على مفتاح API صفحة عبر Google أو البريد الإلكتروني. يظهر المفتاح على الفور بعد التسجيل.
أرسل أول إكمال محادثة لك
أرسل طلب نصي بسيط إلى /v1/chat/completions النقطة النهائية. يُرجع النموذج نصًا غير مقيد بناءً على طلبك.
استخدم معرف النموذج uncensored. يقبل API المعاملات القياسية مثل temperature و top_p. يمكنك ضبط هذه للتحكم في الإبداع.
تمكين التدفق والتعامل مع الرموز
تمكين التدفق لتلقي الرموز كما يتم إنشاؤها. يقلل هذا من زمن الاستجابة المُدرَك للاستجابات الطويلة.
تعيين stream=True في طلبك. يرسل الخادم أحداث خادم المراسلة (SSE). تظهر تفاصيل استخدام الرموز في الجزء الأخير.
عالج التدفق في الكود الخاص بك لعرض الإخراج بشكل تدريجي.
اختبار وضع JSON واستدعاء الوظائف
استخدم وضع JSON لإخراج البيانات المهيكلة. تعيين response_format إلى {"type": "json_object"}. يضمن ذلك أن يُعيد النموذج بيانات JSON.
تمكين استدعاء الوظائف بتقديم tools تعريف. يمكن للنموذج استدعاء الأدوات بناءً على سياق طلبك. استخدم tool_choice لإجبار أو السماح باستخدام الأدوات.
حدود، أخطاء ونافذة السياق
اعرف حدودك قبل توسيع تكاملك. نافذة السياق هي 100,000 رمز إجمالاً.
الحد الأقصى للإخراج لكل طلب هو 16,000 رمز. تحصل على 300 طلب في الدقيقة لكل مفتاح. يُسمح بثمانية طلبات متزامنة لكل مفتاح.
التعامل مع الأخطاء مثل 401 للمفاتيح غير الصالحة أو 402 لعدم كفاية الرصيد. الأخطاء مجانية، لذا لا تستهلك الطلبات الخاطئة الرصيد.
cURL
curl https://api.qwenmaxapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 arguments against cloud computing"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenmaxapi.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenmaxapi.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);التدفق
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)