الربط و API
دون تخمين

01 / البداية

البداية السريعة

1. سجّل أو سجّل الدخول في Rate Cloud. أكّد بريدك الإلكتروني. للحصول على وصول تجريبي مجاني لمدة ثلاث ساعات، اربط Telegram في لوحة التحكم؛ وبعد انتهاء الفترة التجريبية يلزم اشتراك للنموذج المحدد.
2. افتح الإعدادات ← مفاتيح API وأنشئ المفتاح. انسخ السر فورًا: بعد إغلاق النافذة لن يُعرض مرة أخرى.
3. افتح الربط من لوحة التحكم, اختر البرنامج ونظام التشغيل. تعرض علامة التبويب «تلقائي» أمرًا جاهزًا بمفتاحك، إذا كان التثبيت التلقائي مدعومًا.
4. الصق الأمر في Terminal أو PowerShell وانتظر رسالة نجاح التثبيت وأعد تشغيل البرنامج واختر Rate Cloud. إذا كنت تفضل الإعداد اليدوي، افتح علامة التبويب «يدويًا» في نفس الصفحة.
5. أرسل رسالة اختبار قصيرة. تحتوي قائمة النماذج داخل البرنامج على جميع العناصر الخمسة؛ وسيتم تنفيذ الطلب إلى النموذج عند وجود اشتراك نشط أو وصول تجريبي وصلاحية مناسبة للمفتاح.

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

02 / الوصول

كيفية إصدار مفتاح API

1. في لوحة التحكم اضغط «الإعدادات» وانتقل إلى كتلة «مفاتيح API» واضغط «+ إنشاء مفتاح».
2. أعط المفتاح اسمًا واضحًا، مثل «Codex على الحاسوب المحمول». الاسم لك فقط.
3. في «الوصول إلى النماذج» اختر «جميع النماذج النشطة» إذا كنت تريد استخدام الاشتراكات المستقبلية تلقائيًا. خيار «النماذج المحددة فقط» يقيد المفتاح بالنماذج المدرجة؛ شراء اشتراك آخر لا يزيل هذا التقييد وحده.
4. اختر وصول IP: «أي IP» للحاسوب المحمول العادي أو قائمة العناوين المسموحة للخادم الدائم. حدد مدة الصلاحية. إذا كنت تستخدم Codex أو Claude Code، فعّل مربع الاختيار «دعم Codex / Claude Code».
5. اضغط «إنشاء مفتاح» وانسخ السر المعروض. احفظه ككلمة مرور. إذا فقدت السر، أصدر مفتاحًا جديدًا. لا تضع المفتاح في مستودع عام أو في طلب دعم.

يتحكم المفتاح في الوصول، والاشتراك — في حق تنفيذ الطلبات إلى نموذج معيّن. قد تظهر قائمة جميع النماذج الخمسة حتى بدون اشتراك؛ وهذا يسمح بعدم إعادة تهيئة العميل بعد الشراء. لـ Codex وClaude Code يلزم مفتاح مع تفعيل التوافق. فتح مفاتيح API ←

03 / الكتالوج

جميع النماذج الخمسة

في الحقل model مرر ID إلى API تمامًا كما في الجدول. يُكتب ID بأحرف لاتينية صغيرة مع نقاط وشرطات تمامًا كما في الجدول. لا تضف بادئة إلى ID ratecloud/ في الـ API المباشر: وهو مطلوب فقط لاختيار المزوّد داخل بعض البرامج.

الأسماء الدقيقة لـ Codex و Claude Code

هنا جميع الخيارات مدرجة بدون اختصارات. في Codex حدد السطر المطلوب في model, في Claude Code ← في ANTHROPIC_MODEL.

يُنشأ الاشتراك لكل نموذج على حدة في صفحة الأسعار. تحقق من الوصول التجريبي وتوفر النموذج في لوحة التحكم. إذا كنت مشتركًا في عدة نماذج، فإن الأمر التلقائي يختار افتراضيًا النموذج ذو أقدم اشتراك نشط. وفي عملاء Codex تكون المعرّفات على الشكل ratecloud/glm-5.3, وفي Claude Code — ocx-claude-ratecloud--glm-5.3; نفس الطريقة، استبدل أيًا من المعرّفات الأربعة المتبقية.

04 / للمطورين

HTTP API والطلب الأول

الطلبات إلى /v1 يمرّرون الترويسة Authorization: Bearer مفتاح_API_الخاص_بك. تحقق أولًا من الكتالوج، ثم أرسل طلبًا بسيطًا. تستخدم هذه الأمثلة GLM 5.3؛ استبدل المعرّف بأحد النماذج الخمسة الذي يتوفر له وصول فعّال.

macOS / Linux: Terminal

printf 'Вставьте مفتاح API: '; read -r -s RATE_CLOUD_API_KEY; echo
curl -fsS https://llm.rate-cloud.com/v1/models \
  -H "Authorization: Bearer $RATE_CLOUD_API_KEY"
curl -fsS https://llm.rate-cloud.com/v1/chat/completions \
  -H "Authorization: Bearer $RATE_CLOUD_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"Ответь: работает"}]}'
unset RATE_CLOUD_API_KEY

Windows: PowerShell

$env:RATE_CLOUD_API_KEY = Read-Host 'الصق مفتاح API الخاص بك'
$headers = @{ Authorization = "Bearer $env:RATE_CLOUD_API_KEY" }
Invoke-RestMethod 'https://llm.rate-cloud.com/v1/models' -Headers $headers
$body = @{ model = 'glm-5.3'; messages = @(@{ role = 'user'; content = 'Ответь: работает' }) } | ConvertTo-Json -Depth 5
Invoke-RestMethod 'https://llm.rate-cloud.com/v1/chat/completions' -Method Post -Headers $headers -ContentType 'application/json' -Body $body
Remove-Item Env:RATE_CLOUD_API_KEY

لـ SDK المتوافق مع OpenAI حدد Base URL https://llm.rate-cloud.com/v1, مفتاحك وأحد المعرّفات من الجدول. ولطلب Responses مباشر استخدم المفتاح نفسه و /v1/responses.

05 / البرامج

Codex CLI والتطبيق وVS Code

الطريق البسيط: في لوحة التحكم اختر «Codex» ونظام التشغيل و«تلقائي». يستخدم الأمر مفتاحًا مع تفعيل «دعم Codex / Claude Code». وبعد التثبيت افتح قائمة النماذج واختر Rate Cloud. تستخدم إضافة VS Code لـ Codex إعدادات Codex.

الإعداد اليدوي

1. ثبّت Codex حسب تعليمات OpenAI. أغلق Codex وVS Code.
2. افتح ~/.codex/config.toml على macOS/Linux أو %USERPROFILE%\.codex\config.toml في Windows. إذا كان الملف موجودًا، فاحفظ نسخة. وإذا لم يكن موجودًا، فأنشئ ملف نصي بهذا الاسم.
3. أضف المعاملات العامة في بداية الملف قبل الأقسام بين قوسين مربعين. أضف قسم الموفر في النهاية. احتفظ ببقية الإعدادات.

model = "ratecloud/glm-5.3"
model_provider = "ratecloud"

[model_providers.ratecloud]
name = "Rate Cloud"
base_url = "https://llm.rate-cloud.com/codex/v1"
wire_api = "responses"
env_key = "RATE_CLOUD_API_KEY"

في الطرفية التي تشغل منها Codex، عيّن RATE_CLOUD_API_KEY بسرّك: على macOS/Linux — export RATE_CLOUD_API_KEY='مفتاح_API_الخاص_بك', في PowerShell — $env:RATE_CLOUD_API_KEY='مفتاح_API_الخاص_بك'. ثم في نفس النافذة شغّل codex. عند تشغيل VS Code من الطرفية استخدم code ., بحيث تحصل الإضافة على المتغير نفسه. وللنماذج الأخرى استبدل الجزء بعد ratecloud/ إلى المعرّف المطلوب من الجدول.

للحصول على مثال يدوي دقيق لنظام التشغيل المحدد استخدم علامة التبويب «يدويًا» في لوحة التحكم. قارن صيغة المزوّد مع بتوثيق Codex.

06 / البرامج

Claude Code

لـ Claude Code تحتاج مفتاحًا مع تفعيل توافق Codex / Claude Code ووصول ساري إلى النموذج المحدد. في لوحة التحكم اختر Claude Code ونظام التشغيل: سيضبط الأمر الآلي اكتشاف النماذج الخمسة. ويبدأ اسم النموذج في هذا العميل بـ ocx-claude-ratecloud--.

تشغيل يدوي دون تعديل الملفات

ثبّت Claude Code, افتح Terminal أو PowerShell وحدّد ثلاثة متغيرات قبل الأمر claude. استبدل فقط مفتاح_API_الخاص_بك ولاحقة النموذج إن رغبت.

macOS / Linux

export ANTHROPIC_BASE_URL='https://llm.rate-cloud.com/claude'
export ANTHROPIC_AUTH_TOKEN='مفتاح_API_الخاص_بك'
export ANTHROPIC_MODEL='ocx-claude-ratecloud--glm-5.3'
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL='https://llm.rate-cloud.com/claude'
$env:ANTHROPIC_AUTH_TOKEN='مفتاح_API_الخاص_بك'
$env:ANTHROPIC_MODEL='ocx-claude-ratecloud--glm-5.3'
claude

تنطبق هذه المتغيرات على الطرفية الحالية. يحفظ التثبيت التلقائي الإعدادات في ~/.claude/settings.json أو %USERPROFILE%\.claude\settings.json, دون المساس بسجل المحادثات. ولمزيد من التفاصيل عن المتغيرات والإعدادات ← في بتوثيق Claude Code.

07 / البرامج

OpenCode

يضيف الأمر التلقائي في لوحة التحكم موفر Rate Cloud وجميع النماذج الخمسة إلى تكوين OpenCode. يراعي تنسيق إصدار OpenCode المثبت. على Windows يوجد التكوين في %USERPROFILE%\.config\opencode\opencode.json; على macOS/Linux ← في ~/.config/opencode/opencode.json.

مثال يدوي لـ OpenCode v1

أنشئ نسخة من الملف الحالي، وافتحه في محرر نصوص، وأضف المزوّد إلى الكائن provider. لملف جديد يناسب المثال الكامل أدناه. استبدل مفتاح_API_الخاص_بك إلى السر، واحفظ الملف، وأعد تشغيل OpenCode، وافتح /models.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "ratecloud/glm-5.3",
  "provider": {
    "ratecloud": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Rate Cloud",
      "options": {
        "baseURL": "https://llm.rate-cloud.com/v1",
        "apiKey": "مفتاح_API_الخاص_بك"
      },
      "models": {
        "glm-5.3": {"name": "GLM 5.3"},
        "glm-5.3-flash": {"name": "GLM 5.3 Flash"},
        "deepseek-v4.1-flash": {"name": "DeepSeek V4.1 Flash"},
        "deepseek-v4-pro": {"name": "DeepSeek V4 Pro"},
        "qwen-3.8-max": {"name": "Qwen 3.8 Max"}
      }
    }
  }
}

يستخدم OpenCode v2 تنسيقًا مختلفًا providers. لا تُدرج مثال v1 في إعداد v2: يوجد مثال جاهذ لكلا الإصدارين في علامة التبويب «يدوي» في لوحة التحكم. التوثيق الرسمي لـ OpenCode.

08 / البرامج

OpenClaw وContinue وHermes وغيرها

لـ OpenClaw وContinue وHermes في لوحة التحكم تتوفر أوامر تلقائية لـ Windows و macOS و Linux، وكذلك أمثلة يدوية مع مسارات الملفات وأزرار النسخ. اختر البرنامج ونظام التشغيل قبل نسخ الأمر.

OpenClaw يدويًا

1. أغلق OpenClaw. افتح المحدد أعلاه openclaw.json واحفظ النسخة.
2. أضف موفرًا ratecloud в models.providers, دون حذف السجلات الأخرى. في agents.defaults.model.primary أدخل المطلوب ratecloud/ID.
3. استبدل مفتاح_API_الخاص_بك, احفظ الملف وأعد تشغيل OpenClaw. أدناه مثال أدنى لملف جديد؛ وللملف الموجود انقل حقول Rate Cloud فقط.

{
  "models": {"providers": {"ratecloud": {
    "baseUrl": "https://llm.rate-cloud.com/v1",
    "apiKey": "مفتاح_API_الخاص_بك",
    "api": "openai-completions",
    "models": [
      {"id":"glm-5.3","name":"GLM 5.3"},
      {"id":"glm-5.3-flash","name":"GLM 5.3 Flash"},
      {"id":"deepseek-v4.1-flash","name":"DeepSeek V4.1 Flash"},
      {"id":"deepseek-v4-pro","name":"DeepSeek V4 Pro"},
      {"id":"qwen-3.8-max","name":"Qwen 3.8 Max"}
    ]
  }}},
  "agents": {"defaults": {"model": {"primary": "ratecloud/glm-5.3"}}}
}

Continue لـ VS Code يدويًا

1. ثبّت إضافة Continue، وأغلق VS Code، واحفظ النسخة ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
2. في المصفوفة models: أضف سجلًا لكل نموذج. وللملف الجديد استخدم المثال أدناه؛ وإذا كان الملف موجودًا فاحتفظ بسجلاته الأخرى وأضف أربع كتل أخرى بالنمط نفسه مع تغيير name и model حسب الجدول.
3. استبدل مفتاح_API_الخاص_بك, احفظ الملف وأعد تشغيل VS Code. وفي قائمة النماذج في Continue اختر «Rate Cloud · GLM 5.3».

name: Rate Cloud
version: 1.0.0
schema: v1
models:
  - name: Rate Cloud · GLM 5.3
    provider: openai
    model: glm-5.3
    apiBase: https://llm.rate-cloud.com/v1
    apiKey: مفتاح_API_الخاص_بك
    useResponsesApi: false
    roles: [chat, edit, apply]

لجميع النماذج الخمسة دون تكرار يدوي للكتلة استخدم الأمر التلقائي من لوحة التحكم: سيضيف الكتالوج الكامل.

Hermes يدويًا

1. أغلق Hermes وافتح ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml) واحفظ نسخة.
2. أضف الموفر والنموذج حسب المثال أدناه. إذا كان الملف يحتوي بالفعل على إعدادات أخرى، ادمج الإدخالات دون استبدال الملف بالكامل.
3. في الملف المجاور .env أضف السطر RATE_CLOUD_API_KEY="مفتاح_API_الخاص_بك". احفظ الملفين وأعد تشغيل Hermes.

model:
  provider: ratecloud
  default: glm-5.3
  base_url: https://llm.rate-cloud.com/v1
  api_mode: chat_completions
providers:
  ratecloud:
    api: https://llm.rate-cloud.com/v1
    api_key: ${RATE_CLOUD_API_KEY}
    models: [glm-5.3, glm-5.3-flash, deepseek-v4.1-flash, deepseek-v4-pro, qwen-3.8-max]

Zed وJetBrains AI Assistant ومحررات أخرى

1. في إعدادات المحرر ابحث عن AI أو Models أو Providers وأضف موفرًا متوافقًا مع OpenAI خاصًا بك. إذا كان المحرر لا يوفر Base URL خاصًا به، فإن مخطط الاتصال هذا لا يناسبه.
2. أدخل الاسم Rate Cloud, Base URL https://llm.rate-cloud.com/v1 وسر مفتاح API. لا تضف /chat/completions في حقل Base URL.
3. أضف النموذج بمعرّف ID الدقيق من الجدول أعلاه واختره للمحادثة. كرر ذلك للأربعة الآخرين إذا كان المحرر لا يحمّل القائمة عبر /models. لـ Zed وJetBrains افتح علامة التبويب خطوة بخطوة «يدويًا» في لوحة التحكم — أسماء الحقول مختلفة.

لـ Zed وJetBrains AI Assistant وامتدادات VS Code تظهر في لوحة التحكم خطوات يدوية بحقول العميل المحدد. يُعرض الأمر التلقائي فقط حيث يمكن للمثبت تعديل التكوين بأمان. لا يوفر Cursor طريقة مؤكدة لتعيين Base URL متوافق عشوائي لهذا المخطط؛ لا تدخل المفتاح في طريقة اتصال غير موثوقة.

09 / الإدارة

كيفية إلغاء Rate Cloud

1. افتح الربط من لوحة التحكم واختر البرنامج ونظام التشغيل نفسيهما المستخدَمين عند التثبيت.
2. انسخ أمر «قطع الاتصال» ونفّذه في Terminal أو PowerShell. سيتحقق المُثبِّت مما إذا كان الملف قد تغيّر بعد التثبيت، ثم يستعيد الإعدادات السابقة من نسخته الاحتياطية. وتبقى المحادثات والمشاريع في مكانها.
3. أعد تشغيل البرنامج. إذا عدّلت الإعدادات يدويًا بعد التثبيت ورفضت الاستعادة الكتابة فوقها، فاحفظ نسخة جديدة من الملف واحذف الإعدادات فقط ratecloud يدويًا.
4. إذا لم تعد بحاجة إلى المفتاح، قم بإلغائه أو حذفه بشكل منفصل في إعدادات مفاتيح API. إزالة المزوّد من البرنامج لا تلغي المفتاح بحد ذاتها.

10 / المساعدة

إذا كان هناك شيء لا يعمل