واجهة برمجة التطبيقات المفتوحة

تتيح Reverie نقطة وصول Chat Completions متوافقة مع OpenAI. وجّه إليها أي عميل OpenAI، ومرّر مفتاح API من Reverie، واستخدم حقل model لتسمية شخصية أو سيناريو بدل نموذج لغوي. تحتفظ Reverie بالمحادثة والذكريات والملخصات عندها، فلا تحتاج كل طلبية إلا إلى رسالتك الجديدة.

يستطيع أي حساب مسجَّل الدخول استخدامها. لا توجد فئة اشتراك ولا قائمة انتظار — تحتاج مفتاح API فقط، لا غير. أنشئ واحدًا ←

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

https://www.reverie.im/api/device/v1
Authorization: Bearer rk_...

الإعدادات ← المزيد ← مفاتيح API تعرض العنوان الأساسي بالضبط في بطاقة API Endpoint، ومعه زر نسخ.

بداية سريعة

curl --no-buffer https://www.reverie.im/api/device/v1/chat/completions \
  -H "Authorization: Bearer $REVERIE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "Luna [abc12345]",
  "messages": [
    {
      "role": "user",
      "content": "Hi"
    }
  ],
  "stream": true,
  "temperature": 0.8
}'

في الإعدادات ← المزيد ← مفاتيح API يوجد أيضًا مُنشئ طلبات يولّد هذه المقاطع الثلاثة باستخدام أحد مفاتيحك الحقيقية وشخصية حقيقية.

حقل model يسمّي شخصية

تفاصيل تحدّد ما إذا كان المعرّف القصير سيُحَل:

• يجب أن يكون [...] في نهاية النص.
• اللاحقة المكوّنة من 8 أحرف أو أقل تُطابَق فقط مع الشخصيات التي لديك معها محادثة أصلًا، على الويب أو عبر الواجهة. أما المعرّف القصير لشخصية لم تفتحها قط فيسقط بصمت.
• لا يجري البحث عن السيناريو إلا حين يكون المفتاح مثبَّتًا على شخصية. ومع مفتاح عام، لا يمكن لمعرّف سيناريو قصير أن يُحَل أبدًا.
• ما زاد عن 8 أحرف يُعامَل كمعرّف كامل.

سرد من يمكنك التحدث إليه

curl https://www.reverie.im/api/device/v1/models \
  -H "Authorization: Bearer $REVERIE_API_KEY"

المفتاح العام يعيد شخصياتك الأخيرة. أما المفتاح المثبَّت على شخصية فيعيد سيناريوهات تلك الشخصية، أو الشخصية نفسها إن لم يكن لها سيناريوهات. وكل مُدخَل يبدو هكذا:

{
	"id": "Luna [abc12345]",
	"object": "model",
	"created": 1759200000,
	"owned_by": "character",
	"permission": [],
	"root": "<full character id>",
	"parent": null
}

انسخ id مباشرة إلى model. أخطاء هذه النقطة تستخدم شكل خطأ بسيطًا بدل غلاف OpenAI.

ما الذي يُقرأ من جسم الطلب

تُقرأ أربعة حقول. وكل ما عداها يُقبل ثم يُهمَل بصمت.

يُتجاهل دون تنبيه: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

كيف تُعالَج messages:

• رسائل system تُسقَط. الشخصية والسلوك يأتيان من حقول الشخصية نفسها، لا من الطلب. حقول التوجيه ←
• لا دعم للرؤية. قد يكون المحتوى نصًّا أو مصفوفة أجزاء، لكن لا تُقرأ إلا أجزاء text؛ أما أجزاء الصور فتُتجاهل.
• لا يُضاف إلى المحادثة إلا آخر رسالة user. والرسائل السابقة من المستخدم تُتجاهل.
• رسائل المساعد تُستخدم فقط لمزامنة السجل (انظر أدناه).
• إن كانت آخر رسالة للمستخدم فارغة أو كلها مسافات، يُعاد missing_user_message.

الاستجابات

الاستجابة غير المتدفقة كائن chat.completion عادي. وfinish_reason دائمًا stop — فاستدعاءات الأدوات الداخلية لا تظهر أبدًا — وعدّادات usage أصفار، لذا قِس التوكنات من إحصاءات الاستخدام في صفحة مفاتيح API لا من الاستجابة.

الاستجابة المتدفقة هي text/event-stream:

1. مقاطع المحتوى: كائنات chat.completion.chunk تحمل delta.content. ولا يُرسَل مقطع delta: {"role": "assistant"} في البداية.
2. مقطع إنهاء، بـ finish_reason يساوي stop أو length أو content_filter. والإنهاء الناتج عن استدعاء أداة يُبلَّغ عنه كـ stop.
3. مقطع استخدام بمصفوفة choices فارغة.
4. data: [DONE].

وإن فشل التوليد في منتصف البث، يُصدر البث data: {"error": {...}} ثم [DONE].

حالة المحادثة

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

وبما أن الخادم يحتفظ بالسجل، فلا حاجة لأن تعيد إرساله.

أي نموذج لغوي يجيب

الشخصية هي التي تقرّر، لا الطلب — إلا إذا سمّيت نموذجًا لغويًا بنفسك. الأولوية من الأدنى إلى الأعلى: نموذج المحادثة الافتراضي، ثم إعداد النموذج الخاص بالشخصية، ثم معرّف نموذج Reverie المُمرَّر في model، وأخيرًا تفضيل النموذج الذي ضبطته لتلك المحادثة في تطبيق الويب، وهو يتغلّب على الجميع. النماذج ←

الأخطاء

أخطاء /chat/completions تستخدم غلاف OpenAI: {"error": {"message", "type", "param": null, "code"}}.

هناك حالتان خارج هذا الغلاف: أخطاء GET /models، وأجسام الطلبات التي يرفضها التحقق (مثل temperature خارج المدى) — وكلتاهما تعيد شكل خطأ بسيطًا.

حدود المعدّل والحصص

لا يوجد في هذه الواجهة حدّ معدّل لكل مفتاح، ولا سقف للتزامن، ولا حصة للطلبات. ما يقيّد استخدامك شيئان فقط:

نافذة النماذج المجانية مشتركة مع دردشة الويب والقصص والروايات والبوتات — فهي حصة واحدة لكل حساب، لا حصة لكل واجهة. النماذج المجانية ←

ولا ترسل Reverie أي webhooks إلى الخارج؛ فليس هناك ما تشترك فيه لتصلك أحداث انتهاء التوليد.

استيراد الشخصيات

وهناك نقطة وصول ثانية، POST /api/v1/characters/import، تُنشئ شخصية من بطاقة شخصية. وهي تحتاج مفتاحًا بصلاحية الاستيراد، وليس هذا نوع المفاتيح الذي تنشئه صفحة الإعدادات. مفاتيح API ← واستيراد الشخصيات ←

ذات صلة

• مفاتيح API — إنشاء المفاتيح وتثبيتها وتحديد صلاحيتها ومتابعتها
• النماذج — معرّفات النماذج ومُضاعِفات الأرصدة
• الحدود — بقية السقوف في المنتج
• الأرصدة — كيف تُسعَّر الطلبات