دليل لوحة التحكم

استخدام لوحة تحكم QCode.cc: عنوان الوصول إلى API، وإنشاء مفاتيح API ونسخها، وإحصاءات الاستخدام، وشحن الرصيد، وشراء الخطة، والمفاتيح الفرعية للفريق، وtoken الوصول إلى Open API

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

سجّل الدخول على qcode.cc وافتح لوحة التحكم على qcode.cc/dashboard. تلخص لوحة التحكم نفسها في سطر واحد — «إدارة مفاتيح API وشحن الرصيد والاستخدام» — وهي صفحة واحدة: المفاتيح والرصيد والخطط والاستخدام ومكافآت الإحالة والدعم كلها موجودة فيها.

ألست متأكدًا مما يعنيه مفتاح QCode مقابل اشتراك Claude / ChatGPT؟ اقرأ الاشتراكات مقابل مفاتيح API مقابل مفاتيح QCode أولًا. هل أنت خارج البر الرئيسي للصين؟ ابدأ بـ QCode للمستخدمين خارج البر الرئيسي للصين.

ما تحتويه لوحة التحكم¶

عنوان الوصول إلى API¶

يُعنون هذا القسم بـ عنوان الوصول إلى API، ولكل صف زر نسخ خاص به. يعتمد الصف المميز كموصى به على لغة لوحة التحكم التي سجلت الدخول إليها:

• الواجهة الصينية — https://asia.qcode.cc/api مميز كصف موصى به، وتظهر تحته الملاحظة «على مستخدمي البر الرئيسي للصين استخدام العنوان المسرّع؛ ويستخدم الآخرون العنوان العالمي. ويقدم كلاهما أداءً متطابقًا».

• أي واجهة غير صينية (حاليًا الإنجليزية واليابانية والروسية) — https://api.qcode.cc مميز، وتُوسم الصفوف تحته بـ احتياطي (الولايات المتحدة: https://us.qcode.cc/api، آسيا: https://asia.qcode.cc/api).

لا يزال على العنوان الذي تنسخه أن يحمل بادئة المسار الصحيحة للأداة التي تستخدمها — راجع نقاط النهاية ومسارات API. وبالنسبة إلى Claude Code يبدو الزوج هكذا:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

مفاتيح API: الإنشاء والعرض والنسخ¶

إدارة مفاتيح API هي الكتلة التي تحتوي زر إنشاء مفتاح وتفعيل الخدمة. إذا لم يكن لديك مفتاح بعد، توضّح الحالة الفارغة ترتيب العمليات: شحن الرصيد → شراء خطة → بدء الاستخدام.

1. اشحن الرصيد على qcode.cc/recharge (انظر نظرة عامة على طرق الدفع).
2. اختر خطة على qcode.cc/subscribe — إما الخطط الموصى بها أو إعداد مخصص — وأكّد. تعرض عملية شراء ناجحة رسالة «تم تفعيل الاشتراك — تم إنشاء مفتاح API الخاص بك وهو جاهز للاستخدام» وتعرض المفتاح مع زر نسخ ورابط الانتقال إلى لوحة التحكم.
3. في لوحة التحكم، لا تُطبع قيمة المفتاح افتراضيًا: يعرض الصف جارٍ التحميل… إلى أن تضغط زر العين للكشف عنه، ثم نسخ. إذا نسخت قبل تحميل القيمة، تنبّهك لوحة التحكم إلى ذلك بدل نسخ سلسلة فارغة.

أمور أخرى في الكتلة نفسها:

• قد يعرض مفتاح طُلب للتو «جارٍ تفعيل مفتاح API، وسنعالجه في أقرب وقت ممكن» مع رابط إلى الدعم عبر الإنترنت.
• قد يعرض مفتاح تملكه بالفعل زر تجديد (تجديد سريع يُحسب سعره من رصيدك).

• تظهر المفاتيح التي نفدت ضمن قائمة المفاتيح المنتهية الصلاحية المطوية، موسومة بـ منتهي الصلاحية أو معطّل.

• تحصل الحسابات التي اشترت باقة الدفع حسب الاستخدام على بطاقة إضافية مفتاح الدفع حسب الاستخدام (تظهر لهذه الحسابات فقط): الحالة (نشط / استُنفدت الحصة / منتهية الصلاحية)، والحصة المتبقية، وتاريخ انتهاء الصلاحية مع الأيام المتبقية، وعدد الطلبات المتزامنة، وزري شراء المزيد والترقية إلى خطة شخصية. يمتلك الحساب مفتاح باقة واحدًا، وتتراكم التجديدات عليه؛ ويؤدي الشراء مجددًا بعد انتهاء الصلاحية إلى استعادة المفتاح نفسه.

• تربط كل بطاقة العملاء الثلاثة الذين يخدمهم مفتاح واحد: Claude وCodex وGemini (لا يوفّر QCode نماذج Gemini حاليًا).

أوامر الإعداد بنقرة واحدة¶

تحتوي كل بطاقة مفتاح نشط على كتلة الإعداد بنقرة واحدة (موصى به) مع علامتي تبويب macOS / Linux وWindows، وسطر أوامر واحد لـ Claude Code وآخر لـ Codex، لكل منهما زر نسخ الخاص به:

curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash

تلميح لوحة التحكم أسفل الكتلة: «الصق مفتاحك أعلاه عندما يطلبه النص البرمجي.» وفي علامة تبويب Windows تكون الأوامر مكافئة لـ irm … | iex، ويضيف قسم مطوي أسفلها أمرًا أحادي السطر لـ CMD ومشغّلًا قابلًا للتنزيل للأجهزة التي يكون فيها irm غير متاح أو محظورًا بواسطة سياسة التنفيذ. الدليل التفصيلي الكامل، بما في ذلك كيفية فرض لغة واجهة النص البرمجي، موجود في نص الإعداد بنقرة واحدة.

إحصاءات الاستخدام¶

ترتبط كتلة إحصاءات الاستخدام بمفتاحك النشط («استخدام الحصة للمفتاح النشط الحالي») ويمكنها التحديث التلقائي وفق مؤقت (إيقاف / 5 / 10 / 30 / 60 دقيقة) أو عند الطلب عبر تحديث.

هل ترى claude-sonnet-5 في استدعاءات النماذج اليوم رغم أنك لم تختره قط؟ على الأرجح هذه طلبات فحص السلامة التي يرسلها Claude Code في وضع الأذونات auto؛ راجع لماذا يظهر Claude Sonnet 5 في استخدامك.

إخلاء المسؤولية الخاص باللوحة: «قد تختلف البيانات المعروضة هنا اختلافًا طفيفًا، والحدود الفعلية تستند إلى استجابات Claude Code.» للحصول على رقم تقريبي لكل جلسة استخدم /cost داخل Claude Code، ولمعرفة كيفية حساب المبلغ راجع وصف الفوترة.

شحن الرصيد والخطط وباقات التعزيز والترقيات¶

• الرصيد لكل عملة على حدة. «رصيد CNY ورصيد USD منفصلان. ستُضاف قيمة الشحن إلى رصيد العملة المقابلة.» يعرض شريط المستخدم الرقمين جنبًا إلى جنب.
• حدود شحن الرصيد المعروضة في صفحة الشحن: الحد الأدنى ¥30 لعملة CNY، والحد الأدنى $5 والحد الأقصى $2,000 لعملة USD، إضافة إلى حدود لكل طريقة دفع توضحها الصفحة عند بلوغها.
• العودة بعد شحن الرصيد: تعرض لافتة لوحة التحكم «تم استلام الرصيد — يمكنك تفعيل خطة الآن.» مع زر اختيار خطة. ولا يضيع أي مبلغ متبقٍ — «أي رصيد يتبقى بعد شحنك لا يُهدر: استخدمه لاحقًا نحو ترقية أو باقة تعزيز.»
• الشراء لأشهر متعددة: سعر شهري أقل ابتداءً من 3 أشهر (−10% / −20% / −25%)؛ تعرض لوحة التحكم «ابتداءً من 3 أشهر، وفّر 10% شهريًا؛ 20% عند 6 أشهر و25% عند 12 — 12 شهرًا بسعر 9 أشهر. تُدفع مرة واحدة، دون تجديد تلقائي.»
• باقات التعزيز (باقة التعزيز ذاتية الخدمة) يمكن شراؤها من لوحة التحكم باستخدام الرصيد وتوسّع حصتك فورًا؛ ويُعاد ضبطها عند الساعة 2 صباحًا بتوقيت بكين (UTC+8).
• باقات الدفع حسب الاستخدام: تتراكم عمليات التجديد على مفتاح الباقة نفسه، وتاريخ انتهاء الصلاحية هو الأبعد بين تاريخ انتهاء الصلاحية الحالي واليوم مضافًا إليه أيام الباقة؛ وإذا أردت لاحقًا خطة شخصية، فاشترها فقط وستظل الباقة تعمل حتى تنتهي صلاحيتها. الباقات غير قابلة للاسترداد؛ والقواعد في باقات الدفع حسب الاستخدام.
• الترقيات ليست زرًا في لوحة التحكم: اشترِ الخطة الأعلى أولًا، ثم راسل hi@qcode.cc حتى تُغلق الخطة القديمة وتُضاف قيمتها غير المستخدمة مرة أخرى إلى رصيدك.

المفاتيح الفرعية وميزات الفرق¶

تدير لوحة التحكم الشخصية مفتاحًا رئيسيًا واحدًا لكل خطة (ومفتاح باقة واحدًا لكل حساب في باقات الدفع حسب الاستخدام) — ولا توجد فيها شاشة للمفاتيح الفرعية للخدمة الذاتية. المفاتيح الفرعية جزء من منتجات الفرق:

• تصف صفحة خطة الفرق مركز إدارة مفاتيح API الفرعية مع «إعداد وإدارة دقيقة لكل عضو في الفريق»، ويعرض جدول مقارنة الخطط مفاتيح فرعية غير محدودة، ولكل منها حصتها الخاصة. وتدرج تلك الخطة أيضًا دعم التحويل البنكي واتفاقيات خدمة مخصصة. الخطوات: دليل خطة الفرق.

• في صفحة الاشتراك، تعلن بطاقة الفريق عن «إدارة مرنة للحصة والمفاتيح الفرعية» وتشير إلى hi@qcode.cc.

• لا تقدّم لوحة التحكم نفسها سوى توجيه نحو الفرق — مدخل الفريق / المؤسسات في مربع حوار الترحيب ومربع حوار ميزات الفريق الخاص بخطة الفرق («إدارة الحسابات المتعددة للتعاون بين الفريق»، «خدمة مخصصة…»، «دعم فني مخصص…»).

• يحصل الموزّعون على لوحة تحكم منفصلة للشركاء تتضمن إصدار المفاتيح الفرعية، وهي مشروحة في دليل Open API للشركاء.

token الوصول إلى Open API¶

تقول بطاقة Open API: «استخدم token وصول للاستعلام برمجيًا عن تاريخ انتهاء صلاحية مفاتيح API لديك واستخدامها اليومي.» يفتح إدارة token المسار /dashboard/openapi-token، حيث يمكنك إنشاء token أو إعادة تعيينه أو إبطاله:

curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys

• تُدرج في تلك الصفحة نقطتا نهاية للقراءة فقط: واحدة لتاريخ انتهاء صلاحية جميع مفاتيحك النشطة واستخدامها، وواحدة لملخص الاستخدام على مستوى الحساب.

• يُعرض token مرة واحدة: «token الجديد الخاص بك (يُعرض مرة واحدة فقط) — انسخه الآن»، و«نخزّن تجزئة فقط — إذا فقدته، فأعد التعيين للحصول على token جديد (يتوقف token القديم عن العمل فورًا).»

• تطلب كل من إعادة التعيين والإبطال تأكيدًا، ويؤدي الإبطال إلى تعطيل الوصول إلى Open API حتى تنشئ token جديدًا.

• يبدأ token الشخصي هذا بـ qot_. وهو ليس token الموزّع: يحصل الشركاء على token من نوع rsk_ في لوحة تحكم الشركاء ضمن «Open API / Access Token»، وهذا الأخير يصرّح بالوصول إلى Partner Open API (الرصيد، الاستخدام، إدارة المفاتيح الفرعية). ولا يمكن استخدام أحدهما بدل الآخر — راجع دليل Open API للشركاء.

أسئلة الدعم والطلب¶

• سطر الدعم في لوحة التحكم: «استجابة عبر الإنترنت أيام الأسبوع 10:00 - 21:00 (UTC+8)»، مع رسائل خارج أوقات العمل «تُفحص على فترات متقطعة، وقد تتأخر الردود»، و«البريد الإلكتروني متاح في أي وقت: hi@qcode.cc».

• الدعم المباشر هو زر تواصل معنا في الزاوية السفلية اليمنى (Telegram أو البريد الإلكتروني).

• يوضّح طلب المعالجة العاجلة سبب الانتظار: تستغرق الحسابات المُجهّزة حديثًا من ساعة إلى ساعتين لتطبيقها وإعدادها خلال ساعات العمل.

• تضم الروابط السريعة أيضًا مساعدة الاستخدام (قاعدة المعرفة) ورموز الأخطاء الشائعة؛ للاطلاع على الأعراض والإصلاحات راجع دليل استكشاف الأخطاء وإصلاحها و مرجع رموز الأخطاء.

الصفحات ذات الصلة¶

• نظرة عامة على طرق الدفع — طرق الدفع التي يقبلها شحن الرصيد
• وصف الفوترة — كيف يتحول الاستخدام إلى مبلغ مالي
• باقات الدفع حسب الاستخدام — أسعار الباقات وتجديدها وانتهاء صلاحيتها
• كيف تختار خطة — الخيارات الأربعة جنبًا إلى جنب
• نقاط النهاية ومسارات API — العنوان مع بادئة المسار
• متغيرات البيئة — أين تضعها
• سكربت الإعداد بنقرة واحدة — ما تفعله أوامر لوحة التحكم
• الاشتراكات مقابل مفاتيح API مقابل مفاتيح QCode
• دليل خطة الفرق — المفاتيح الفرعية والتحويل المؤسسي
• دليل Open API للشركاء
• الأسئلة الشائعة

المؤسسات ←