Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

DEEPSEEK HARNESS + RUNAPI

استخدم RunAPI في DeepSeek Harness.

أضف RunAPI بصفته Custom model API في dsh، واستخدم https://runapi.ai/v1 عبر OpenAI Chat Completions، وتحادث مع gpt-5.4-nano من واجهة الويب أو في وضع التشغيل دون واجهة.

تم التحقق باستخدام dsh 0.2.1-rc.2 مع محاكاة محلية · دون أي استدعاء مدفوع للمزوّد الخارجي
- id: llm-pi-ai
  config:
    providers:
      runapi:
        apiKeyEnv: RUNAPI_API_KEY
        api: openai-completions
        baseURL: https://runapi.ai/v1
        models:
          - id: gpt-5.4-nano
- id: agent-default-model
  config:
    provider: runapi
    model: gpt-5.4-nano
export RUNAPI_API_KEY="runapi_xxx"
npx @deepseek-ai/[email protected] --version
npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
npx @deepseek-ai/[email protected] web --patch runapi.patch.yml
تم التحقق باستخدام dsh 0.2.1-rc.2/v1
النطاق

نموذج واحد ومحادثة نصية واحدة

الهدف

تمكين مستخدمي DeepSeek Harness من توجيه طلبات المحادثة عبر RunAPI باستخدام عنوان URL الأساسي ومفتاح API الخاصين بهم، دون إضافة أصلية للمزوّد.

أبسط إعداد يعمل

مزوّد Custom model API واحد باسم runapi، ونموذج واحد هو gpt-5.4-nano، ورسالة نصية واحدة تتلقى ردًا.

إصدار مثبّت

تم التحقق من الإعداد والأوامر باستخدام @deepseek-ai/dsh 0.2.1-rc.2. ثبّت هذا الإصدار باستخدام npx إلى أن تتحقق بنفسك من إصدار أحدث.

نطاق التحقق دون طلبات مدفوعة

تم التحقق من تحميل dsh وبنية الطلبات والردود ورسائل الخطأ باستخدام محاكاة محلية لنقطة نهاية RunAPI. لم يُرسل أي طلب مدفوع إلى مزوّد خارجي لإعداد هذه الصفحة.

الإعداد

اربط dsh مع RunAPI في ثلاث خطوات

1

صدّر مفتاح RunAPI

عيّن RUNAPI_API_KEY في الصدفة التي تشغّل dsh. يقرأ ملف التعديل المفتاح من البيئة، لذا لا يُحفظ المفتاح في أي ملف.

export RUNAPI_API_KEY="runapi_xxx"
2

أضف Custom model API

احفظ runapi.patch.yml لاستخدامه مع --patch، أو أضف القيم في Settings → Models → Add model provider → Custom model API. تحفظ الواجهة ملف إعداداتها الخاص والمفتاح في مخزن بيانات الاعتماد؛ أما --patch فيجعل هذه الحقول للقراءة فقط في Settings.

api: openai-completions
3

أرسل رسالة نصية واحدة

شغّل مهمة واحدة دون واجهة أو افتح واجهة الويب باستخدام ملف التعديل. في الواجهة، اختر runapi/gpt-5.4-nano من محدّد النماذج قبل المحادثة. ظهور رد في الطرفية أو المحادثة يعني أن dsh وصل إلى RunAPI.

npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
المرجع

حقول Custom model API

الحقل القيمة الغرض
معرّف المزوّد runapi معرّف دائم تستخدمه الجلسات والإعدادات الافتراضية ومرجع بيانات الاعتماد.
عنوان URL الأساسي https://runapi.ai/v1 يرسل الطلبات إلى نقطة نهاية RunAPI المتوافقة مع OpenAI.
بروتوكول API openai-completions بروتوكول OpenAI Chat Completions الذي يقدّمه RunAPI على /v1/chat/completions.
بيانات الاعتماد RUNAPI_API_KEY تُقرأ من البيئة باستخدام apiKeyEnv أو تُحفظ من خلال صفحة Models.
النموذج gpt-5.4-nano نموذج نصي متزامن منخفض التكلفة ضمن كتالوج RunAPI.
اختبار المحادثة

تحقّق من المفتاح والنموذج قبل استخدام dsh

يستخدم هذا الطلب المتزامن عنوان URL الأساسي والمفتاح والنموذج نفسها الموجودة في ملف التعديل، ويحدّ الرد بـ 64 رمزًا. إذا أعاد رسالة، فسبب تعطل dsh هو إعداد dsh وليس حساب RunAPI.

curl https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.4-nano", "max_tokens": 64, "messages": [{"role": "user", "content": "Reply with one short sentence."}]}'
استكشاف الأخطاء وإصلاحها

أخطاء DeepSeek Harness

يتوقف dsh مع MISSING_CREDENTIAL. ما الذي ينقص؟

لم يُعيّن RUNAPI_API_KEY في الصدفة التي شغّلت dsh. صدّر المتغير أو احفظ المفتاح في صفحة Models، ثم شغّل الأمر نفسه مجددًا.

يعرض dsh خطأ 404 أو خطأ اتصال. هل عنوان URL الأساسي غير صحيح؟

غالبًا نعم. يجب أن يكون عنوان URL الأساسي مطابقًا تمامًا لـ https://runapi.ai/v1؛ إذ يضيف dsh المسار /chat/completions بنفسه. أما خطأ الاتصال فيعني تعذّر الوصول إلى المضيف أصلًا.

يعرض dsh الخطأ 404 Resource not found رغم صحة عنوان URL. ما الذي يجب التحقق منه؟

تحقّق من معرّف النموذج في كتالوج نماذج RunAPI، مثل gpt-5.4-nano، وتأكد من أن agent-default-model يستخدم المزوّد runapi ومعرّف النموذج المطابقين.

هل أحتاج إلى إضافة أصلية لمزوّد RunAPI؟

لا. يدعم dsh خيار Custom model API لبروتوكول OpenAI Chat Completions، ويقدّم RunAPI هذا البروتوكول، لذا يكفي ملف التعديل للمحادثة النصية.

احصل على مفتاح RunAPI لاستخدامه مع dsh.

أنشئ حساب RunAPI أو سجّل الدخول، وأنشئ مفتاح API، ثم صدّره باسم RUNAPI_API_KEY قبل تشغيل dsh.