دليل البدء السريع لواجهة برمجة تطبيقات Qwen

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

استخدم مفتاح API الخاص بك مع عنوان URL الأساسي HTTPS://api.apiqwen.com/v1. تعمل نقطة النهاية هذه مع مكتلات OpenAI الرسمية وأي عميل متوافق. مرر المفتاح في Authorization رأس. لا تستخدم عناوين URL الوكيل من مزودي الخدمات الآخرين. خدمتنا مستقلة وتدير نموذجها الخاص غير الخاضع للرقابة. يمكنك إنشاء مفتاح عبر Google أو البريد الإلكتروني في لوحة التحكم. يظهر المفتاح فوراً بعد التسجيل. لا يلزم رقم هاتف.

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

أرسل طلبات POST إلى /v1/chat/completions. استخدم معرف النموذج "uncensored". يقبل الطرف رسائل الدردشة القياسية. يعيد استجابات نصية فقط. لا يدعم التضميمات أو الصور. قم بتكوين معلمات مثل درجة الحرارة و top_p. اضبط response_format على json_object للبيانات المنظمة. استدعاء الوظائف متاح عبر الأدوات. تتم معالجة الطلبات على خوادمنا المخصصة. يضمن ذلك زمن استجابة متسق. تحقق من عنوان URL الأساسي بعناية. تسبب عناوين URL الخاطئة أخطاء 404.

تفاصيل النموذج والحدود

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

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

فعّل التدفق عن طريق تعيين stream إلى true. تُعيد واجهة برمجة التطبيقات أحداث مرسلة من الخادم. يظهر استخدام الرمز في الجزء الأخير. يتيح هذا العرض في الوقت الفعلي. استخدم هذا لواجهات الدردشة. يقلل من زمن الاستجابة المُدرَك. اقرأ الأجزاء بالتسلسل. تعامل مع الاستجابات الجزئية بعناية. يعمل نمط JSON مع التدفق. يتم تدفق استدعاءات الوظائف أيضاً. راقب عدد الرموز. تتراكم التكاليف لكل مليون رمز. الإدخال بسعر $0.15. الإخراج بسعر $0.50. يتتبع الرصيد الاستخدام. ينطبق الفوترة بالعملات المشفرة. قم بإضافة الرصيد باستخدام USDT أو USDC.

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

عالج أخطاء 401 بالتحقق من المفتاح. تأكد من صحة رأس المصادقة. استخدم أخطاء 402 للكشف عن انخفاض الرصيد. قم بإضافة رصيد عبر العملات المشفرة للمتابعة. تشير أخطاء 429 إلى حدود معدل الطلبات. انتظر قبل إعادة المحاولة. يعمل التراجع الأسي بشكل أفضل. تحقق من حدود التزامن. لا تتجاوز 8 طلبات. يجب أن يكون حجم الجسم أقل من 8 ميجابايت. يسبب JSON غير صالح أخطاء 400. تعيد معرفات النماذج المجهولة أخطاء 400. سجل الأخطاء لأغراض التصحيح. صفحة الدعم تصلح مشكلات الفواتير. لا ينتهي الرصيد. لا يتم إصدار استرداد. الأخطاء مجانية.

البدء السريع مع مكتبة Python

ثبّت الحزمة openai. اضبط عنوان URL الأساسي. مرر مفتاح API الخاص بك. استدعِ chat.completions.create. استخدم النموذج "uncensored". اضبط stream إلى true. كرر عبر القطع. اطبع الرموز. تعامل مع الاستثناءات. أغلق العميل. هذا يعمل مع الكود الحالي. استبدل عنوان URL الأساسي. احفظ مفتاح API بأمان. استخدم متغيرات البيئة. اختبر بمطالبات صغيرة. تحقق من استخدام الرموز. راقب التكاليف. ترقية إلى أرصدة مدفوعة. الدفع بالعملات المشفرة فقط. USDT أو USDC. إعداد سريع.

cURL

Copycurl https://api.apiqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python function"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)