أين تُدخل مفتاح API الخاص بك: الدردشة، المحرر، الطرفية، الشيفرة

الصق المفتاح في الأداة التي تناسب مهمتك: دردشة في المتصفح (Open WebUI) إن كنت تريد فقط التحدث إلى نموذج، أو إضافة في المحرر (Cline، Kilo Code) إن كنت تكتب الشيفرة في VS Code، أو أداة طرفية (Aider، OpenCode) إن كنت تعمل في الصدفة، أو سكربت من عشرة أسطر إن كنت تبني شيئًا بنفسك. كلها تأخذ الأشياء الثلاثة نفسها: عنوان ومفتاح ومعرّف نموذج.

شحنت الرصيد وحصلت على المفتاح، والآن هناك حقل نصي في مكان ما يطلبه. أي حقل؟ يعتمد ذلك على ما تريد فعله بعد ذلك، فابدأ من هناك.

الأشياء الثلاثة التي تطلبها كل أداة#

أيًا كان شكل الأداة، فإن شاشة الإعدادات تطلب الثلاثي نفسه:

• عنوان URL الأساسي: https://api.cheaptokens.dev/v1 (تتحدث الأداة إلى هذا العنوان بدلًا من العنوان الافتراضي). إن كانت الكلمة جديدة عليك، فإن ما هو base_url وكيفية تبديله يستغرق ثلاث دقائق.
• مفتاح API: السلسلة السرية من حسابك. تعامل معها ككلمة مرور؛ كيفية تخزينها بأمان.
• معرّف النموذج: الاسم الكامل، مثل deepseek-ai/DeepSeek-V4-Flash-0731. الأسماء المختصرة من جداول الأسعار لا يقبلها API، لذا انسخ المعرّف الكامل من التوثيق.

يتحدث CheapTokens API بروتوكولي OpenAI Chat Completions وAnthropic Messages، لذا يمكن للأدوات التي تتيح لك تعيين عنوان URL أساسي مخصص لأي من العائلتين الاتصال، وتغطيها الأدلة أدناه. رصيد واحد يغطي كل النماذج.

اختر حسب المهمة#

اسأل نفسك ماذا تريد أن ترى على الشاشة بعد خمس دقائق.

ملاحظة سريعة عن Claude Code: يستخدم صيغة Anthropic، لذا عنوانه https://api.cheaptokens.dev بدون /v1. دليله يحتوي على المتغيرات الدقيقة.

إن كنت جديدًا: ابدأ بالدردشة#

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

لدردشة كهذه، MiniMax-M2.7 (سياق 180K، حتى 8,192 رمز إخراج لكل إجابة) خيار خفيف للأسئلة القصيرة المتكررة.

إن كنت تكتب الشيفرة: محرر أم طرفية؟#

هذا في الغالب مسألة أين يداك الآن.

في VS Code، Cline وKilo Code إضافتان تجلسان في لوحة جانبية وتعملان على ملفات مشروعك. تفتح إعدادات المزود، تختار مزودًا متوافقًا مع OpenAI، وتلصق القيم الثلاث من أعلاه.

في الصدفة، يعمل Aider وOpenCode على مستودعك من الطرفية. يُضبط OpenCode بملف opencode.json، وAider عبر متغيرات البيئة أو إعداد؛ يعرض الدليلان الأسطر الدقيقة.

لهذه الأدوات، النموذج أهم من الواجهة، لأن حلقة الوكيل قد تستمر لخطوات كثيرة. DeepSeek-V4-Flash (سياق 380K، حتى 32,768 رمز إخراج لكل إجابة، سعر واحد في أي ساعة دون تسعير للذروة) خيار افتراضي جيد هنا: هناك متسع للتعديلات الطويلة.

إن كنت تكتب الشيفرة: تجاوز الأدوات#

أقصر طريق هو بلا أداة على الإطلاق. عيّن المفتاح في متغير بيئة وأرسل طلبًا واحدًا:

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Say hi in five words"}]}'

الرد كائن JSON: النص في choices[0].message.content، وحقل usage يوضح عدد رموز الإدخال والإخراج التي استخدمها الطلب. الاستدعاء نفسه في Python وNode وبصيغة البث موجود في أول طلب لك.

كم يكلف التجريب#

رسالة دردشة أو طلب محرر صغير. خذ طلبًا نموذجيًا: 2,000 رمز إدخال (سؤالك زائد الملفات أو السجل الذي ترسله الأداة) و500 رمز إخراج، 100 مرة. إليك الجدول المباشر:

طلب واحد كهذا على MiniMax-M2.7 يكلف $0.00018. لهذا الحمل، هو أرخص من OpenRouter إجمالًا، مع احتساب الإدخال والإخراج معًا. الأسعار ثابتة لكل نموذج، دون ساعات ذروة؛ قائمة الأسعار كاملة على صفحة التسعير.

GLM-5.3-Flash متاح أيضًا في الأدوات نفسها (سياق 390K، حتى 8,192 رمز إخراج، وسعر إخراج أقل من OpenRouter)، لذا يمكنك تبديل النماذج في الإعدادات بتغيير معرّف النموذج فقط (خذ المعرّف الكامل من التوثيق).

إن لم يعمل#

معظم إخفاقات التشغيل الأول تأتي من ثلاثة مواضع:

• الأداة ما زالت تتحدث إلى العنوان الافتراضي. تحقق من أن حقل عنوان URL الأساسي يحمل https://api.cheaptokens.dev/v1 وأنك لم تلصقه في حقل مخصص لشيء آخر.
• معرّف النموذج هو الاسم المختصر. استخدم صيغة deepseek-ai/DeepSeek-V4-Flash-0731 الكاملة.
• المفتاح فيه مسافة أو سطر جديد شارد من النسخ. الصقه مرة أخرى.

لنصوص الأخطاء مثل 401 أو 429، راجع أخطاء الاتصال الشائعة.

أين تبحث عن مزيد من الأدوات#

هناك أدوات أكثر بكثير من المذكورة أعلاه. كتالوج المجتمع Awesome AI DevTools RU (تم التحقق منه في 23 أكتوبر 2026) يسرد 281 أداة في 20 فئة بتسميات مثل BYOK (أحضر مفتاحك)، وMCP، والنماذج المحلية، والمفتوح المصدر، لذا فهو مكان مناسب للتصفح. قبل أن تختار أداة منه، افتح توثيق تلك الأداة وابحث عن عنوان URL أساسي مخصص أو إعداد مزود متوافق مع OpenAI: هذا ما يتيح لها العمل بمفتاحك.

مستعد للبدء؟ افتح التوثيق، وانسخ عنوان URL الأساسي ومعرّف النموذج، واختر صف الجدول الذي يطابق مهمتك.