ربط OpenHands بـ CheapTokens: النموذج وBase URL والمفتاح

يمكنك تشغيل OpenHands على نموذج من CheapTokens بملء ثلاثة حقول في Settings > LLM بعد تفعيل Advanced: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731)، وBase URL (https://api.cheaptokens.dev/v1)، وAPI Key. هذا هو الإعداد كله. وبقية هذه الصفحة تشرح معنى كل حقل وكيف يبدو الأمر عندما يكون أحدها خاطئًا.

أسماء الحقول وقاعدة سلسلة النموذج مأخوذة من صفحة وثائق OpenHands حول نقاط النهاية المتوافقة مع OpenAI (تم التحقق في 8 نوفمبر 2026؛ لا تحتوي الصفحة على تاريخ أو إصدار). أحدث إصدار من OpenHands في ذلك التاريخ هو v1.37.0 (6 نوفمبر 2026). إذا بدا تسمية حقل في نسختك مختلفة قليلًا، فاعتمد على الموضع: النموذج، ثم Base URL، ثم المفتاح.

قبل فتح Settings#

ثلاثة أشياء في متناول يدك ستوفر عليك جولة كاملة: المفتاح، ومعرّف النموذج، والوصول إلى Settings.

جديد على المفاتيح وBase URLs؟ يغطي What base_url is and how to switch ذلك في بضع دقائق، ويوضح list models with GET /v1/models كيفية البحث عن معرّف بنفسك.

الحقول الثلاثة#

افتح Settings > LLM وفعّل Advanced. يقع حقل Base URL أسفل مفتاح Advanced.

تصف الوثائق قاعدة النموذج على النحو التالي: Custom Model هو openai/ متبوعًا باسم النموذج، وإذا كنت تمر عبر وكيل (proxy) له بادئة خاصة به، فاستخدم openai/<proxy-prefix>/<model-name>. الجزء الذي يلي openai/ هو اسم النموذج. بالنسبة إلى CheapTokens، المعرّف هو deepseek-ai/DeepSeek-V4-Flash-0731، لذا تكون السلسلة الكاملة openai/deepseek-ai/DeepSeek-V4-Flash-0731.

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

تفضل GLM؟ استخدم openai/zai-org/GLM-5.3-Flash (سياق 390K، وما يصل إلى 8,192 رمز إخراج) في الحقل نفسه دون تغيير أي شيء آخر. الرصيد نفسه، والمفتاح نفسه، وBase URL نفسه.

تحقق من الأجزاء خارج OpenHands أولًا#

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

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 ready"}],"max_tokens":20}'

لاحظ ما هو غائب: لا يوجد openai/ في قيمة model. تلك البادئة مخصصة لـ OpenHands، وليس لـ API. تحمل الإجابة كتلة usage تتضمن prompt_tokens وcompletion_tokens — وهما الرقمان نفسهان اللذان ستراهما لاحقًا يتراكمان على مدار جلسة الوكيل.

كيف يبدو الحقل الخاطئ#

يمكن أن يكون كل حقل من الحقول الثلاثة هو السبب:

• مفتاح خاطئ. تجيب API بالرمز 401 — المفتاح مفقود، أو مكتوب بشكل خاطئ، أو به مسافة زائدة من النسخ.
• Base URL خاطئ. يذهب الطلب إلى المكان الخطأ فتحصل على 404 أو خطأ اتصال. يجب أن ينتهي العنوان بـ /v1 وألا يحتوي على مسار إضافي.
• سلسلة نموذج خاطئة. إما أن البادئة مفقودة، أو أن المعرّف الذي يليها ليس المعرّف الكامل (لا تقبل API إلا gateway_id الكامل، وليس معرّفًا قصيرًا مثل deepseek-v4-flash-0731).

التفسير الكامل للفرق بين 401 و404 موجود في API 401 or 404: wrong key, base URL or model id.

تكلفة جلسة واحدة#

يحاسب الوكيل على السياق كله في كل خطوة، وليس على مهمتك المكوّنة من سطر واحد. لنفترض أن OpenHands يعمل على إصلاح خطأ لمدة 40 خطوة، مع إرسال نحو 30,000 رمز وإعادة كتابة 1,500 رمز في كل خطوة. تكلفة الخطوة الواحدة على DeepSeek-V4-Flash هي $0.0006؛ وأربعون منها موضحة أدناه، إلى جانب النماذج الأخرى وOpenRouter.

إجمالًا، مع احتساب الإدخال والإخراج معًا، يخرج DeepSeek-V4-Flash أرخص من OpenRouter لهذا الحمل. الافتراضات متروكة لك لتغييرها: قد يستغرق إصلاح قصير 10 خطوات، وإعادة هيكلة كبيرة 100 خطوة. الأسعار الحالية على pricing page، وصفحة النموذج هي cheap DeepSeek.

تستخدم OpenHands بالفعل مع مزوّد آخر؟#

إذن أنت تستبدل ثلاث قيم فقط: Custom Model، وBase URL، وAPI Key. لا يتغير أي شيء آخر في المشروع، ويمكنك العودة بالطريقة نفسها. الاتصال خطوة بخطوة بـ API نفسها موجود في CheapTokens docs؛ وإعداد مشابه في أداة مختلفة هو connect Aider.