AR ▾
احصل على مفتاح API

uncensoredqwen.comالدليل

مفتاح API لـ Qwen في VS Code: إعداد نقطة النهاية المخصصة

لاستخدام مفتاح API لـ qwen في VS Code لا تحتاج إلى إضافة خاصة بـ Alibaba. أي إضافة تدعم مزودًا متوافقًا مع OpenAI تقبل ثلاث قيم: عنوان URL الأساسي، والمفتاح، واسم النموذج. توفر هذه الدليل القيم الدقيقة والفحوصات التي تكشف الأخطاء الشائعة.

تم التحديث

لوحة محرر أكواد متساوي القياس مع مفتاح ذهبي متصل بمقبض نقطة النهاية مرتبط بخادم

ما تحتاجه قبل فتح VS Code

مفتاح API الخاص بـ qwen لـ VS Code هو مجرد مفتاح API بالإضافة إلى إعدادات نقطة النهاية الصحيحة في الامتداد. اجمع هذه القيم الثلاث أولاً:

  • عنوان URL الأساسي: https://api.uncensoredqwen.com/v1
  • معرف النموذج: uncensored
  • مفتاح API: تم إنشاؤه في صفحة مفتاح API بعد تسجيل الدخول باستخدام Google أو باستخدام البريد الإلكتروني وكلمة المرور

يمكن للحسابات الجديدة الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة على تلك الصفحة. لا يحتاج إلى بطاقة، ومحدود بنقرة واحدة لكل شخص، ويظل صالحًا لمدة 7 أيام. هذا يكفي لاختبار إعداد المحرر لبضعة أيام من البرمجة الحقيقية.

ملاحظة حول التسمية: الخدمة هي نموذج مفتوح الأوزان مستضاف وتشغله شركة مستقلة. إنها ليست API الرسمي لشركة Alibaba، وليست وسيطًا لمتاجر أخرى. في محرر النصوص الخاص بك، يظهر تحت اسم العرض الذي تعطيه له.

اختبر المفتاح باستخدام curl أولاً

قبل تغيير أي إعداد للمحرر، تأكد من أن المفتاح وURL يعملان بشكل مستقل. إذا فشل هذا، فلن ينجح أي امتداد، وستعلم أن المشكلة تكمن في المفتاح وليس في البرنامج المساعد.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

قائمة JSON التي تتضمن uncensored تعني أن المصادقة تعمل. بعد ذلك، أرسل استجابة حقيقية واحدة:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'

تتضمن رؤوس الاستجابة X-Balance-USD، وهي طريقة سريعة لمعرفة الرصيد المتبقي دون مغادرة الطرفية.

أضف المزود في امتداد VS Code

يمكن لعدة امتدادات VS Code لمساعدة البرمجة بالذكاء الاصطناعي التحدث مع أي خادم متوافق مع OpenAI. تختلف التسميات قليلاً من أداة إلى أخرى، لكن الحقول تتطابق واحدًا تلو الآخر. ابحث عن خيار مزود باسم "OpenAI Compatible" أو "OpenAI" مع عنوان URL أساسي مخصص، أو "Custom endpoint".

حقل الامتدادالقيمة التي تُدخلها
المزودمتوافق مع OpenAI (أو OpenAI مع عنوان URL أساسي مخصص)
عنوان URL الأساسي / أساس APIhttps://api.uncensoredqwen.com/v1
مفتاح APIالمفتاح من حسابك
معرّف النموذجuncensored

الإضافات التي تقرأ ملف تكوين JSON عادةً ما تتطلب شيئًا بهذا الشكل. تختلف أسماء الحقول الدقيقة، لذا تحقق من وثائق الإضافة الخاصة بك وعدّل أسماء الحقول:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

لا تقم بإيداع هذا الملف. إذا كانت إعداداتك موجودة داخل مستودع، فاستخدم تخزين الأسرار الخاص بالامتداد أو متغير البيئة بدلاً من ذلك، وأضف مسار التكوين إلى .gitignore.

بعد الحفظ، افتح لوحة الدردشة الخاصة بالامتداد وأرسل رسالة قصيرة مثل "اشرح هذه الدالة" مع فتح ملف. يعني الإجابة المتدفقة أن الإعداد قد اكتمل.

أصلح أخطاء التكوين الشائعة

تعود معظم الإعدادات الفاشلة إلى عدد قليل من الأخطاء المطبعية. اعمل على هذه القائمة بالترتيب.

عنوان URL له شكل خاطئ

ينتهي عنوان URL الأساسي بـ /v1. تضيف الامتدادات /chat/completions بنفسها. إذا لصقت المسار الكامل، فستحصل على خطأ 404 لأن العميل يطلب /v1/chat/completions/chat/completions. عادةً ما يكون الشريط المائل في النهاية غير ضار، لكن غياب /v1 ليس كذلك.

اسم النموذج غير صحيح

بعض الإضافات تملئ تلقائيًا قائمة منسدلة باسماء النموذج من خدمة أخرى. استبدله بـ uncensored بالضبط، بحروف صغيرة. إذا كان الحقل قائمة منسدلة بدون إدخال مخصص، ابحث عن خيار "نموذج مخصص" أو "آخر".

المفتاح يحتوي على أحرف زائدة

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

الإضافة لا تزال تتصل بخادمها الافتراضي

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

يفشل الطلب مع 429

هذا حد معدل، مغطى في القسم التالي. جسم الخطأ يحمل رمزاً يحدد الحد الذي وصلته.

تحقق من وصول الطلبات حقاً إلى API

نادرًا ما يخبرك المحرر أي خادم أجاب. خطوتان سريعتان تزيلان الشك.

  1. راقب الرصيد. شغّل الأمر /v1/models أو استدعاء إكمال قصير من الطرفية، لاحظ رأس X-Balance-USD، أرسل ثلاث رسائل دردشة في المحرر، ثم أعد استدعاء الطرفية. يجب أن ينخفض الرقم بمقدار صغير. نفس الرقم متاح من GET /v1/balance.
  2. اطلب شيئاً سيرفضه الإعداد الافتراضي أو يعالجه بشكل مختلف. اختبار صغير وغير ضار هو طلب رد مكون من خمس كلمات بالضبط. إذا اتبع الجواب التعليمات ووصل عبر البث المتدفق، فإن الاتصال سليم.

إذا لم يتحرك الرصيد، افتح لوحة إخراج الإضافة أو وحدة المطور. تسجل معظم الإضافات عنوان URL للطلب وحالة HTTP، ويظهر المضيف الخاطئ فوراً. صحح عنوان URL الأساسي، أعد تحميل النافذة وحاول مرة أخرى.

يجب أن يمنح الفرق التي تشارك مستودعاً لكل شخص مفتاحاً منفصلاً بدلاً من قيمة مشتركة واحدة. بهذه الطريقة، لا يحجب حد المعدل الذي يصله شخص واحد الآخرين، ويمكن استبدال المفتاح المسرب دون إزعاج الآخرين.

الاقتراح التلقائي، الدردشة وحدود المعدل

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

اعرف الأرقام. المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. المفتاح التجريبي يسمح بـ 2 متزامن و60 في الدقيقة. عند تجاوزها، ترد API بـ HTTP 429 والرمز rate_limited (أكثر من اللازم في الدقيقة) أو concurrency (أكثر من اللازم في وقت واحد). في حالات الحمل المؤقت، تحصل أيضاً على 429 مع رأس Retry-After: 5. يحافظ الإكمال المتدفق على فتحة التزامن حتى ينتهي البث، لذا فإن البث البطيء يحسب ضدك لفترة أطول.

إعدادات عملية تساعد:

  • استخدم الخدمة للدردشة والتعديلات والشروحات، وأوقف الاقتراح التلقائي أو ارفع زمن تأخير الإكمال التلقائي (debounce) أثناء استخدام مفتاح تجريبي.
  • خفض الحد الأقصى لرموز الإخراج للاقتراح التلقائي إلى بضع عشرات. الإكمال القصير ينتهي بسرعة ويحرر الفتحة.
  • تجنب تشغيل نوافذ محرر متعددة ضد نفس المفتاح أثناء التجربة.

الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا الأخطاء لا تكلف شيئاً سوى الوقت.

تكلفة جلسة كتابة الأكواد

موجهات البرمجة ثقيلة الإدخال لأن الإضافات تلتصق بمحتوى الملفات. التسعير هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. فكر في دورة دردشة واحدة ترسل 6,000 رمز من الكود والسياق وتسترد 800 رمز:

  • الإدخال: 6,000 × $0.15 / 1,000,000 = $0.0009
  • الإخراج: 800 × $0.50 / 1,000,000 = $0.0004
  • المجموع: $0.0013 لكل دور

عند 100 من هذه الأدوار في يوم عمل، يكون ذلك $0.13. يغطي الرصيد التجريبي بقيمة $0.50 حوالي 380 دورًا بهذا الحجم ($0.50 / $0.0013 يساوي حوالي 385). الرصيد مسبق الدفع، لا ينتهي، وشحن الرصيد يكون بمبالغ كاملة من $20 إلى $500، مع مكافأة بنسبة 5% من $50، و10% من $100، و15% من $200. انظر صفحة الأسعار لطرق الدفع.

نافذة السياق هي 100,000 رمز، الموجّه والإكمال. إذا فهرست إضافة مستودعك بالكامل في كل موجّه، فستكون الطلبات الكبيرة أكثر تكلفة وتقترب من ذلك الحد. حدّ السياق إلى الملفات التي تحتاجها فعلاً.

الخصوصية وكيفية قراءة المزيد

لا تُستخدم الموجّهات في التدريب. ومع ذلك، غالباً ما تحتوي شفرة المصدر على أسرار، لذا احتفظ بملفات .env وبيانات الاعتماد خارج الملفات التي ترفقها إلى الدردشة. تسمح لك معظم الإضافات باستبعاد المسارات من نافذة السياق.

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

أسئلة وأجوبة

أين أحصل على مفتاح API لـ Qwen في VS Code؟

سجّل في الموقع، وافتح صفحة مفتاح API وأنشئ مفتاحاً. يمكنك أيضاً الحصول على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة، دون الحاجة إلى بطاقة.

ما هي Base URL التي أدخلها في الإضافة؟

استخدم https://api.uncensoredqwen.com/v1 ولا تضف /chat/completions. معرف النموذج هو uncensored.

لماذا ترجع لي الإضافة خطأ 401؟

المفتاح عادةً ما يكون خاطئاً، أو يحتوي على مسافة زائدة، أو ينتمي إلى حساب آخر. أعد نسخه واختبره باستخدام أمر curl إلى /v1/models.

هل يمكنني استخدامه لتكامل الإكمال التلقائي؟

يعمل من خلال إعدادات الإكمال التلقائي المتوافقة مع OpenAI، لكن الطلبات المتكررة قد تصل إلى حد 60 طلباً في الدقيقة الخاص بالرصيد التجريبي. يسمح المفتاح الكامل بـ 300 طلب في الدقيقة.

مفتاحك على بُعد استمارة واحدة

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.

احصل على مفتاح API