مفاتيح المطوّر

من يستطيع إنشاء مفتاح

ينتمي مفتاح المطوّر إلى حسابك في ToRun. لإنشاء مفتاح، يحتاج حسابك إلى:

• عنوان بريد إلكتروني مؤكَّد،
• خطة مدفوعة أو رصيد مشترى، لأن الحصة المجانية لا تدفع أبدًا ثمن استدعاءات API.

أنشئ مفتاحًا

1. افتح صفحة المطورين في حسابك على ToRun.
2. اضغط إنشاء مفتاح واملأ النموذج:
   • الاسم: شيء يخبرك بمكان استخدام المفتاح، مثل «opencode على حاسوبي المحمول».
   • حد الإنفاق الشهري (Runs): أقصى ما يمكن لهذا المفتاح إنفاقه في شهر.
   • اسأل قبل أي عملية إنشاء واحدة تتجاوز (Runs): أي عملية إنشاء تكلّف أكثر من هذا المبلغ تسألك أولًا.
   • عندما تنفد حصة خطتي، اسمح لهذا المفتاح بالإنفاق من محفظتي: اتركه معطّلًا إذا كان يجب أن يستخدم المفتاح حصة خطتك فقط.
3. اجتز فحص الأمان وأنشئ المفتاح.
4. انسخ المفتاح. فهو يُعرض مرة واحدة فقط.

أبقِ المفتاح خارج ملفاتك

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

في macOS وLinux، في ملف تعريف الصدفة (shell) لديك (مثل ~/.zshrc أو ~/.bashrc):

export TORUN_API_KEY="trn_live_..."

في Windows، في PowerShell (ثم افتح نافذة طرفية جديدة):

setx TORUN_API_KEY "trn_live_..."

لا تضف مفتاحًا أبدًا إلى مستودع (commit)، ولا تضعه في ملف إعداد تشاركه مع الآخرين.

المتابعة والإلغاء

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

إلغاء يوقف المفتاح فورًا: الأداة التي تستخدمه تُرفض في استدعائها التالي. إذا كان المفتاح قد تسرّب، فألغِه وأنشئ مفتاحًا جديدًا.

هناك حدّ لعدد المفاتيح النشطة التي يمكن أن يحملها الحساب، ولعدد المفاتيح التي يمكنه إنشاؤها في اليوم.

الخطوة التالية

• خادم MCP من ToRun: ما الذي تفعله الأدوات وكيف تُدفع الاستدعاءات.
• اربط أداة: opencode، Claude Code، Cursor.