توثيق API ونقاط النهاية

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

تتطلب واجهة برمجة التطبيقات مفتاحًا صالحًا لكل طلب. أنت تنشئ هذا المفتاح على الفور عند التسجيل باستخدام Google أو عنوان بريد إلكتروني. مرر المفتاح في Authorization رأس باستخدام Bearer scheme. عنوان URL الأساسي لجميع الطلبات هو HTTPS://api.qwenaipricing.com/v1. يعمل هذا الرابط مع مكتبات SDK الرسمية لـ OpenAI وأي عميل متوافق عن طريق تحديث التكوين الأساسي فقط.

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

النقطة النهائية الأساسية هي POST /v1/chat/completions. يقبل جسم JSON يحتوي على messages مصفوفة و model الحقل. اضبط معرف النموذج على "uncensored" للوصول إلى نموذج اللغة الكبير المُعدّل للإخراجات غير المقيدة. يمكنك تحديد أدوار النظام والمستخدم والمساعد لهيكلة سياق محادثتك.

Copycurl https://api.qwenaipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
  }'

يشمل الرد المحتوى المُولّد، وإحصائيات الاستخدام، وسبب الانتهاء. تُرجع الأخطاء أكواد HTTP القياسية مثل 401 للمفاتيح غير الصالحة أو 402 إذا استنفدت رصيدك المدفوع مسبقًا. لا تدعم واجهة برمجة التطبيقات نقاط النهاية الخاصة بالتضمينات، أو توليد الصور، أو ضبط النماذج الدقيقة.

تكامل واجهة برمجة تطبيقات Python

استخدم الرسمي openai حزمة Python للتفاعل مع واجهة برمجة التطبيقات. قم بتهيئة العميل عن طريق توفير مفتاح واجهة برمجة التطبيقات الخاص بك وضبط عنوان URL الأساسي ليشير إلى نقطة النهاية الخاصة بنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create() بدون إعادة كتابة منطق العميل الخاص بك. تتعامل المكتبة مع تسلسل JSON وتحليل الاستponses تلقائيًا.

Copyfrom openai import OpenAI

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

مرر رسائلك كقائمة من القواميس. تدعم مكتبة SDK جميع المعلمات القياسية مثل درجة الحرارة و top_p. يضمن هذا التوافق مع قواعد الشفرة الحالية التي تتوقع واجهة متوافقة مع OpenAI.

تكامل SDK Node.js

تعمل حزمة Node.js SDK بشكل مشابه لنسخة Python. قم بتثبيت openai حزمة وقم بتكوين عنوان URL الأساسي ومفتاح API. يمكنك بعد ذلك استدعاء نقطة نهاية إكمال الدردشة بالمعلمات التي تريدها. هذه الطريقة مثالية لتطبيقات الخادم أو الخدمات الخلفية التي تحتاج إلى توليد النص بشكل غير متزامن.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenaipricing.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 الاتصال بـ HTTP ومعالجة الأخطاء نيابةً عنك. يمكنك أيضاً استخدام GET /v1/models نقطة النهاية للتحقق من معرف النموذج المتاح.

التدفق والاستخدام

فعّل البث عن طريق تعيين 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)

تحتوي الشريحة النهائية في التدفق على إجمالي استخدام الرموز الشاردية للطلب. يمكنك تتبع استهلاك رصيدك المدفوع مسبقاً من خلال مراقبة إحصائيات الاستخدام. قد تؤدي الأخطاء أثناء التدفق إلى إنهاء الاتصال مبكراً.

حدود، أخطاء، ونافذة السياق

يدعم النموذج نافذة سياق بحجم 100,000 رمز، تشمل مجتمعةً النص الوارد والإجابة. الحد الأقصى للإخراج لكل طلب هو 16,000 رمز. إذا لم تقم بتعيين max_tokens, الحد هو 2,048 رمزًا. أنت محدود بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يشير خطأ 429 إلى تجاوزك لهذه الحدود. لا تستهلك الطلبات التي تحتوي على أخطاء أو رفضات رصيدًا. لا تقدم الواجهة ضمانات مستوى الخدمة أو الشهادات.