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

مفتاح واجهة برمجة تطبيقات Character AI: كيفية الحصول عليه واستخدامه

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

مفتاح متوهج فوق لوحات الدردشة المتصلة بمكعب الخادم، يوضح الوصول إلى مفتاح واجهة برمجة التطبيقات

نقاط رئيسية

  1. تحصل على مفتاح بعد تسجيل الدخول باستخدام Google أو البريد الإلكتروني وكلمة المرور، ثم فتح صفحة مفتاح API.
  2. يمكن للمستخدمين الجدد المطالبة برصيد تجريبي بقيمة $0.50 بنقرة واحدة، بدون بطاقة، صالح لمدة 7 أيام.
  3. استخدم عنوان URL الأساسي https://api.characteraiapi.com/v1 ومعرف النموذج uncensored مع أي SDK متوافق مع OpenAI.
  4. احتفظ بالمفتاح على خادم أو في متغير بيئة، ولا تضعه أبداً في كود الواجهة الأمامية العام.

ما تحصل عليه فعلياً

Character.ai هو منتج دردشة للمستهلكين. الأشخاص الذين يبحثون عن مفتاح API لـ character ai يريدون عادةً أحد أمرين: طريقة لاستدعاء روبوت دردشة لشخصية من كودهم الخاص، أو خادم خلفي لتطبيق شخصية غير مقيد بقواعد المنتج المستضاف. يغطي هذا الموقع الحاجة الثانية. تسجل حسابك، تحصل على مفتاح، وترسل طلبات إلى نقطة نهاية متوافقة مع OpenAI. لا شيء هنا يتصل بـ Character.ai أو يعيد استخدام شخصياتها.

الخدمة هي واجهة نصية مستضافة أمام نموذج واحد مفتوح الأوزان، يديرها مزود مستقل ومضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. ليست واجهة برمجة التطبيقات الرسمية لأي بائع نماذج وليست موزعًا عبر البائعين. معرف النموذج هو uncensored، وعنوان URL الأساسي هو https://api.characteraiapi.com/v1. توجد طريقتان: POST /v1/chat/completions و GET /v1/models.

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

احصل على مفتاحك في خمس خطوات

تستغرق العملية بأكملها بضع دقائق. لا تحتاج إلى بطاقة للبدء.

  1. سجل الدخول. استخدم Google، أو سجل باستخدام بريد إلكتروني وكلمة مرور.
  2. افتح صفحة المفتاح. اذهب إلى صفحة مفتاح API، حيث يظهر مفتاح حسابك.
  3. استرد التجربة. نقرة واحدة على تلك الصفحة تضيف رصيد تجربة بقيمة $0.50. وهي محدودة بمرة واحدة لكل شخص وتكون صالحة لمدة 7 أيام.
  4. انسخ المفتاح. احفظه في مدير كلمات المرور أو ملف الأسرار فوراً.
  5. أرسل طلب اختبار. استخدم أمر curl أدناه قبل لمس أي كود تطبيق.

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

اختبر المفتاح مع curl

اضبط المفتاح كمتغير بيئة حتى لا يظهر في سجل الطرفية الخاص بك كنص عادي داخل نص برمجي. ثم اطلب قائمة النماذج. هذا يؤكد أن المفتاح يعمل وأنك تصل إلى المضيف الصحيح.

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

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

يجب أن تحصل على قائمة JSON تتضمن uncensored. الآن أرسل طلب دردشة أولي بشخصية صغيرة. رسالة النظام تضبط الشخصية، ورسالة المستخدم تبدأ المشهد.

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

يتبع الرد شكل إكمال الدردشة القياسي. نص الرد موجود في choices[0].message.content. تحمل رؤوس الاستجابة أيضاً X-Request-Id، X-Balance-USD و رؤوس حدّ المعدل، وهو مفيد عندما تريد إظهار الرصيد المتبقي في واجهة المستخدم الخاصة بك.

استخدم المفتاح من Python أو Node

تعمل أي مكتبة SDK متوافقة مع OpenAI بمجرد تغيير قيمتين: عنوان URL الأساسي ومفتاح API. إليك النسخة الخاصة بـ Python باستخدام الحزمة الرسمية openai.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.characteraiapi.com/v1",
    api_key=os.environ["API_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

ونفس الاستدعاء في Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.characteraiapi.com/v1",
  apiKey: process.env.API_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

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

مشاكل مفتاح API الشائعة وحلول سريعة

تنتج معظم حالات الفشل الأولى عن عدد قليل من الأخطاء الصغيرة. تحقق منها بهذا الترتيب قبل أن تشك في وجود مشكلة أكبر.

  • مسافات بيضاء إضافية أو علامات اقتباس في مفتاح API. وجود سطر جديد في نهاية مفتاح API منسوخ من ملف يكفي لإخفاق المصادقة. اطبع طول المتغير وقارنه مع ما نسخته.
  • عنوان URL الأساسي غير صحيح. ينتهي عنوان URL الأساسي بـ /v1، وتضيف مكتبة SDK المسار /chat/completions تلقائيًا. إذا أضفت أيضًا /chat/completions إلى عنوان URL الأساسي، يتضاعف المسار ويخفق الطلب.
  • اسم النموذج غير صحيح. معرف النموذج هو uncensored. لن تتطابق الأسماء المأخوذة من خدمات أخرى. قم باستدعاء GET /v1/models لمعرفة ما يبلّغه الخادم.
  • رأس HTTP مفقود. تتطلب استدعاءات HTTP الخام رأس Authorization: Bearer متبوعًا بمسافة ومفتاح API، بالإضافة إلى رأس Content-Type: application/json في طلبات POST.
  • رصيد فارغ. يُظهر رأس الاستجابة X-Balance-USD الرصيد المتبقي. عندما ينفد رصيد التجربة المجانية أو تنتهي صلاحيته بعد 7 أيام، قم بشحن الرصيد وإلا ستتوقف الطلبات عن النجاح.
  • حدّ المعدل. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 طلب في الدقيقة. يستخدم بثّان مفتوحان كلا الخانتين بالفعل.

يُنتج المفتاح الخاطئ عادةً خطأ في المصادقة بدلاً من رد النموذج. ينتج الحدّ HTTP 429 مع الرمز rate_limited أو concurrency. قراءة جسم الخطأ، وليس فقط رمز الحالة، يوفر الوقت لأن الرمز يخبرك بأي حدّ وصلت إليه. تحمل كل استجابة X-Request-Id؛ احتفظ به في سجلاتك، بحيث يمكنك مطابقة مكالمة فاشلة بطلب معين لاحقاً.

حدود التجربة المجانية وما يشتريه الرصيد التجريبي

يملك مفتاح التجربة حدوداً أقل من المفتاح الكامل: 2 طلب متزامن و60 طلب في الدقيقة. يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يكفي ذلك لاختبار شخصية واحدة. إذا شغلت عدة دردشات في وقت واحد من نص اختبار، فسترى HTTP 429 مع رمز الخطأ concurrency أو rate_limited. يحتفظ الطلب المتدفق بخانة التزامن الخاصة به حتى ينتهي البث، لذا فإن بثّين مفتوحين على مفتاح التجربة يملآنها.

إلى أي مدى يصل $0.50؟ الأسعار هي $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. خذ دورة دردشة نموذجية تحتوي على 1,500 رمز من السجل والشخصية كمدخل و300 رمز كمخرج:

  • المدخل: 1,500 رمز × $0.15 / 1,000,000 = $0.000225
  • المخرج: 300 رمز × $0.50 / 1,000,000 = $0.00015
  • دورة واحدة: $0.000375
  • $0.50 / $0.000375 يساوي حوالي 1,333 دورة

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

الإعدادات التي تجعل الشخصية تبدو صحيحة

يوفر لك مفتاح API الاتصال؛ جودة الشخصية تأتي من الموجّه وإعدادات أخذ العينات. تساعد بعض العادات أكثر من الحيل الذكية.

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

استخدم temperature لضبط الحيوية. تعطي القيم القريبة من 0.9 صياغة أكثر تنوعًا، بينما تحافظ القيم القريبة من 0.5 على استقرار الشخصية. أضف تسلسل stop إذا كان تطبيقك يستخدم تسمية متحدث مثل "المستخدم:" وترغب في منع النموذج من كتابة جانب المحادثة الآخر. يمكن أن تقلل عقوبات التردد والحضور من العبارات المتكررة في الدردشات الطويلة، لكن ارفعها بلطف، لأن القيم العالية يمكن أن تجعل الحوار غريبًا.

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

شحن الرصيد عند نفاد الرصيد التجريبي

لا يوجد اشتراك. تدفع مسبقاً وتنفق حسب الرمز. يمكن أن يكون شحن الرصيد أي مبلغ صحيح يتراوح بين $20 و$500، وتحمل المبالغ الأكبر مكافأة: +5% من $50، +10% من $100 و+15% من $200. لذا يصبح $50 رصيداً بقيمة $52.50، و$100 يصبح $110، و$200 يصبح $230. يمكنك الدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base).

تحتوي صفحة التسعير على الجدول الكامل. للتخطيط، يكلف نفس الدور بـ 1,500 رمز داخلاً و300 رمز خارجاً $0.000375، لذا فإن $20 تغطي حوالي 53,000 من هذه الأدوار. تكلف لعب الأدوار طويل الأمد أكثر لكل دور لأن السجل يزداد، لذا حدد مقدار ما تعيد إرساله. نافذة السياق هي 100,000 رمز، الموجّه بالإضافة إلى الإكمال، لكنك نادراً ما تريد ملئها.

حفظ المفتاح بأمان في تطبيق حقيقي

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

  • احفظ المفتاح في متغير بيئة أو مدير أسرار، وليس في المستودع.
  • أضف إدخال .env إلى .gitignore قبل أول commit.
  • استخدم مفتاحاً واحداً لكل بيئة حتى لا يؤثر التسرب في بيئة التطوير على بيئة الإنتاج.
  • راقب رأس X-Balance-USD لالتقاط الحلقات الخارجة عن السيطرة مبكراً.
  • أعد المحاولة عند HTTP 429 مع انتظار قصير. تتضمن استجابة الحمل الزائد المؤقت Retry-After: 5.

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

أسئلة وأجوبة

هل يمنحني هذا مفتاح Character.ai API؟

لا. هذه خدمة منفصلة ومستقلة. تحصل على مفتاح لنقطة نهاية متوافقة مع OpenAI مع معرف النموذج uncensored، والذي يمكنك استخدامه كواجهة خلفية لتطبيقات الشخصيات الخاصة بك.

هل أحتاج إلى بطاقة للحصول على مفتاح؟

لا. تسجل حسابك باستخدام Google أو البريد الإلكتروني وكلمة المرور، ثم تحصل على $0.50 من الرصيد التجريبي بنقرة واحدة على صفحة مفتاح API. التجربة صالحة لمدة 7 أيام.

هل يمكنني استخدام المفتاح في SillyTavern أو واجهات دردشة أخرى؟

الأدوات التي تقبل نقطة نهاية متوافقة مع OpenAI يمكنها استخدامها. أدخل عنوان URL الأساسي ومفتاحك واسم النموذج uncensored.

ماذا يحدث عندما أصل إلى حدّ المعدل؟

يعيد API استجابة HTTP 429 مع الكود rate_limited أو concurrency. انتظر لحظة وأعد المحاولة. يسمح المفتاح التجريبي بـ 2 طلب متزامن و60 في الدقيقة.

هل ينتهي الرصيد؟

الرصيد المشتري لا ينتهي. فقط رصيد $0.50 التجريبي له نافذة 7 أيام.

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

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

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