أول طلب في خمس دقائق

تثبيت SDK OpenAI

تتبع نقطة النهاية الخاصة بنا بروتوكول chat.completions القياسي، مما يتيح لك استخدام حزم SDK الرسمية بلغتك المفضلة. بالنسبة لـ Python، قم بتثبيت الحزمة عبر pip. بالنسبة لـ Node.js، استخدم npm. تتعامل هذه المكتبات مع التسلسل، إعادة المحاولة، والبث المتدفق out of the box.

pip install openai

npm install openai

تأكد من استخدام إصدار حديث من SDK لدعم جميع المعاملات مثل tool_choice و response_format. تدير مكتبة العميل طلبات HTTP، لذا عليك التركيز فقط على هيكل الحمولة.

تكوين عنوان URL الأساسي والمفتاح

وجّه عميلك إلى نقطة النهاية المخصصة لدينا. لا تحتاج إلى تغيير منطق اسم النموذج؛ نتوقع منك تمرير model: "uncensored" في طلباتك. تتم المصادقة عبر مفتاح API بسيط يمرر في الرأس.

ضبط base_url إلى https://api.qwenapi.top/v1. أنشئ qwen api key الخاص بك على لوحة التحكم. يظهر المفتاح فوراً بعد التسجيل. لا يتطلب الإعداد الأولي رقم هاتف أو بطاقة ائتمان.

طلب إكمال الدردشة الأساسي

أرسل طلب إكمال قياسي. يعيد النموذج استجابات نصية مباشرة. لا توجد طبقات توجيه معقدة؛ أنت تتحدث إلى مثيل واحد مُعد لإخراج بدون رقابة.

يوجد أدناه مثال بسيط باستخدام curl للتحقق من الاتصال وتنسيق الاستجابة.

Copycurl https://api.qwenapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

تحتوي الاستجابة على النص المُولّد في choices[0].message.content. يمكنك تعديل معاملات مثل temperature و top_p للتحكم في الإبداع.

الاستجابات المتدفقة

لتوليد الرموز في الوقت الفعلي، فعّل البث المتدفق. يرسل الخادم أحداث الإرسال من الخادم (SSE). تتضمن الشريحة الأخيرة إحصائيات استخدام الرموز، مما يتيح لك تتبع استهلاك الرصيد بدقة.

Copyfrom openai import OpenAI

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

يعد البث المتدفق ضروريًا للإطالات. يمكنك تحليل التدفق وعرض الرموز عند وصولها. يتعامل SDK مع تحليل SSE تلقائيًا.

دعم استدعاء الدوال

عرّف الأدوات في طلبك. يعيد النموذج استدعاءات أدوات منظمة. نفذ الأداة، مرر النتيجة مرة أخرى، ويستمر النموذج. يعمل هذا مع tool_choice وتعريفات الدوال القياسية.

Copyimport OpenAI from "openai";

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

وضع JSON متاح أيضًا عبر response_format. استخدمه عندما تحتاج إلى إخراج JSON صارم بدون عبء الأدوات.

الحدود والأخطاء والسياق

نافذة السياق هي 100,000 رمز إجمالي. الحد الأقصى للإخراج لكل طلب هو 32,000 رمز (2,048 إذا لم يُحدد). حدود المعدل هي 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب أن تبقى أحجام الطلبات أقل من 8 ميجابايت.

معالجة الأخطاء: 401 يعني مفتاحاً غير صالح، 402 يعني رصيداً غير كافٍ، 429 يعني تجاوز حدّ المعدل. الأخطاء مجانية؛ أنت تدفع فقط مقابل الرموز المستهلكة. الرصيد المسبق الدفع لا ينتهي. إذا حدث شحن مزدوج، استخدم صفحة الدعم للإصلاح.

البث المتدفق

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)