مفاتيح API
إنشاء مفاتيح الواجهة وتحديد نطاقها وإدارتها.
مفتاح API يوثّق الطلبات الموجَّهة إلى واجهة Reverie المفتوحة. والمفاتيح موجودة في الإعدادات ← المزيد ← مفاتيح API، وهو المكان نفسه الذي تشير إليه بطاقة واجهة برمجة التطبيقات المفتوحة في المختبرات. وأي حساب يستطيع إنشاءها — لا شرط لفئة معيّنة ولا حدّ لعدد ما تملكه منها.
إنشاء مفتاح
اضغط «إنشاء مفتاح API جديد»
وحين تكون الصفحة فارغة يكون نص الزر إنشاء مفتاح API الأول الخاص بك.
سمِّه
الاسم مطلوب، من حرف واحد إلى 100 حرف. وهو ما يظهر به المفتاح في القائمة وفي إحصاءات الاستخدام — مثل «سماعة غرفة المعيشة» أو «staging worker».
اختر «عام» أو شخصية بعينها
اختيار الشخصية خيار بين عام (جميع الشخصيات) وشخصية محددة، وليس إضافة اختيارية. والشخصية المحددة تصير الشخصية المثبَّتة على المفتاح.
واختياريًا اضبط نوع الجهاز وتاريخ الانتهاء
نوع الجهاز نص حر (speaker، phone، iot). وانتهاء الصلاحية يأخذ تاريخًا ووقتًا معًا؛ وعند تلك اللحظة يتوقف المفتاح عن العمل من تلقاء نفسه.
يظهر المفتاح فورًا على هيئة rk_ يتبعها 64 حرفًا ستّ عشريًا.
المفاتيح تبقى قابلة للاسترجاع
السرّ لا يُعرض مرة واحدة فقط. ففي بطاقة كل مفتاح توجد إظهار مفتاح API وإخفاء مفتاح API ونسخ مفتاح API، في أي وقت، ما دام المفتاح موجودًا.
ولأن السرّ الكامل يبقى قابلًا للقراءة من إعداداتك، فعامل الوصول إلى الحساب كأنه وصول إلى المفتاح. احفظ المفتاح على خادم أو في مدير أسرار، ولا تضعه أبدًا في نظام إدارة الشيفرة ولا في شيفرة المتصفح.
المفاتيح العامة والمفاتيح المثبَّتة
| عام (جميع الشخصيات) | شخصية محددة | |
|---|---|---|
ما يعيده GET /models | شخصياتك الأخيرة | سيناريوهات تلك الشخصية، أو الشخصية نفسها إن لم يكن لها سيناريوهات |
model متروك | يسقط إلى أحدث محادثاتك | يستخدم الشخصية المثبَّتة |
| معرّفات السيناريو القصيرة | لا تُحَل أبدًا | تُحَل ضمن الشخصية المثبَّتة |
التعطيل والحذف والتدوير
| الإجراء | الأثر | قابل للتراجع |
|---|---|---|
| مفتاح نشط | ما دام مُطفأً، تُرفض الطلبات التي تحمل هذا المفتاح | نعم |
| حذف | يُتلَف المفتاح وتفقد التطبيقات التي تستخدمه إمكانية الوصول | لا |
ولا يوجد إجراء إبطال منفصل — التعطيل والحذف هما الخياران.
حذف المفتاح لا يمكن التراجع عنه، وهو يأخذ معه نسبة استخدامه: إذ تنتقل حركته السابقة إلى مجموعة مفاتيح محذوفة في إحصاءات الاستخدام، حيث لن تعود تميّز أي تكامل أنفق ماذا. فإن كنت قد تحتاج السجل، عطّل المفتاح أولًا.
ولتدوير المفتاح، أنشئ البديل ثم انشره، وبعدها عطّل المفتاح القديم أو احذفه. لا يوجد تدوير تلقائي ولا مهلة سماح بعد انتهاء الصلاحية — فالمفتاح المنتهي يُرفض بـ api_key_expired في الطلب التالي.
النطاقات
المفاتيح تحمل نطاقات، ونافذة الإنشاء لا تُظهرها. والمفتاح الذي تصنعه في الإعدادات يستطيع استدعاء نقاط الدردشة فقط، لا غير.
أما نقطة استيراد الشخصيات فتحتاج نطاقًا مختلفًا، والسبيل الوحيد للحصول على مفتاح كهذا هو فتح المختبرات ← مهارة استيراد الشخصيات، التي تنشئ لك مفتاحًا باسم Reverie Character Importer (Skill). واستدعاء المستورِد بمفتاح عادي من الإعدادات يعيد 403. استيراد الشخصيات ←
إحصاءات الاستخدام
لوحة إحصاءات الاستخدام في الصفحة نفسها تعرض الطلبات والرموز والرصيد والمفاتيح النشطة، مجمّعة بحسب اليوم بتوقيت UTC، مع تفصيل لكل مفتاح تحت الاستخدام حسب المفتاح. رشّح بمفتاح واحد أو بـ جميع المفاتيح، ضمن نافذة من 7 إلى 90 يومًا — 30 يومًا افتراضيًا. ولا تُحتسب إلا المحادثات التي أُنشئت عبر الواجهة.
وهذه اللوحة هي المكان الوحيد الذي يوجد فيه الإنفاق لكل مفتاح. فسجل أرصدتك يدوّن كلفة كل رسالة، لكنه لا يربط العملية بالمفتاح الذي نفّذها، فاستعن بإحصاءات هنا للمقارنة بين التكاملات.
إنشاء طلب
إنشاء طلب يفتح مولّدًا: اختر أحد مفاتيحك النشطة، ثم شخصية أو سيناريو من القائمة التي يراها ذلك المفتاح، واكتب رسالة، وحدّد البث ودرجة الحرارة، ثم انسخ شيفرة cURL أو TypeScript أو Python جاهزة للعمل.
ولا يُستخدم المفتاح في متصفحك إلا لتحميل قائمة الشخصيات. أما الشيفرة المولَّدة فتقرأ REVERIE_API_KEY من البيئة بدل تضمين السرّ داخلها.
الحدود
| الحد | القيمة |
|---|---|
| المفاتيح لكل حساب | بلا حدّ |
| حدّ المعدّل لكل مفتاح | لا يوجد |
| سقف التزامن لكل مفتاح | لا يوجد |
| ما يقيّد الاستخدام فعلًا | رصيدك من الأرصدة، ونافذة النماذج المجانية |
ذات صلة
- واجهة برمجة التطبيقات المفتوحة — نقاط الوصول وشكل الطلب والأخطاء
- استيراد الشخصيات — ما الغرض من مفتاح الاستيراد
- مختبرات Reverie — بطاقتا الواجهة المفتوحة والاستيراد
- الأمان — بقية إعدادات الوصول إلى حسابك