موارد إضافية
روابط مفيدة، مكتبات متوافقة، شروط الاستخدام وجهات الاتصال.
واجهات CloudZIR#
| العنوان | الاستخدام |
|---|---|
| api.cloudzir.com | هذا التوثيق، وواجهة API نفسها (/v1، /anthropic). |
| plateforme.cloudzir.com | المفاتيح، الرصيد، الشحن، الاستهلاك، الدعم. |
| ai.cloudzir.com | دردشة CloudZIR AI، مجانية، لتجربة النماذج بلا شيفرة برمجية. |
| cloudzir.com | CloudZIR : استضافة، نطاقات وخدمات. |
المكتبات المتوافقة#
تعمل المكتبات التي تتحدث بروتوكول OpenAI أو Anthropic ضمن الحدود الموثقة (بعض الحقول تُقبل ثم تُتجاهل أو تُرفض : انظروا صفحات المرجع). الأكثر شيوعًا :
| البيئة | المكتبة | الإعداد |
|---|---|---|
| Python | openai | base_url="https://api.cloudzir.com/v1" |
| Python | anthropic | base_url="https://api.cloudzir.com/anthropic" |
| Python | langchain-openai | ChatOpenAI(base_url=…, model="mina-low") |
| Python | llama-index | OpenAILike(api_base=…, is_chat_model=True) |
| JS / TS | openai | baseURL: "https://api.cloudzir.com/v1" |
| JS / TS | @anthropic-ai/sdk | baseURL: "https://api.cloudzir.com/anthropic" |
| JS / TS | @ai-sdk/openai-compatible | baseURL: "https://api.cloudzir.com/v1" |
| Go | go-openai | config.BaseURL = "https://api.cloudzir.com/v1" |
| PHP | openai-php/client | ->withBaseUri("api.cloudzir.com/v1") |
| أي لغة | HTTP خام | انظروا المرجع |
الوكلاء والمحررات#
Claude Codeوكيل برمجي في الطرفية.
Codexواجهة سطر أوامر لوكيل برمجي.
OpenCodeوكيل مفتوح المصدر.
OpenClawوكيل مستقل.
Cline وContinueإضافتا VS Code.
Aiderبرمجة مساعَدة عبر Git.
ممارسات أمنية جيدة#
- لا تضعوا المفتاح أبدًا في المتصفح ولا في مستودع Git. استخدموا متغيرات بيئة أو مدير أسرار.
- مفتاح واحد لكل بيئة (تطوير، ما قبل الإنتاج، إنتاج) : يصبح الإلغاء دقيقًا ويبقى الاستهلاك مقروءًا.
- كشف الأسرار : أضيفوا النمط
zir_ai_[0-9a-f]{48}إلى قواعدكم (gitleaks، trufflehog، GitHub secret scanning). - تدوير منتظم : أنشئوا المفتاح الجديد، انشروا، ثم ألغوا القديم، دون أي انقطاع.
- راقبوا الرصيد عبر GET /v1/user/balance : استهلاك غير معتاد هو أول علامة على تسرب.
شروط الاستخدام#
باستخدامكم لواجهة برمجة تطبيقات CloudZIR، تلتزمون بـ :
- احترام القانون الجزائري وقانون مستخدميكم النهائيين ؛
- عدم توليد محتوى غير مشروع، ولا انتحال هوية شخص أو مؤسسة ؛
- عدم إعادة بيع الوصول بعلامة بيضاء دون اتفاق كتابي ؛
- إعلام مستخدميكم النهائيين بأنهم يتفاعلون مع نظام ذكاء اصطناعي ؛
- عدم محاولة الالتفاف على حدود المعدل ولا مشاركة مفتاح بين منظمات.
التزام توافر واجهة API هو 99,9 % شهريًا بموجب الشروط العامة (المادة 10.6)، باستثناء الصيانة المُعلَنة والقوة القاهرة ؛ يفتح أي إخلال ثابت الحق في تعويض بالرموز. يمكن لـCloudZIR تعليق وصول في حال إساءة استخدام. الرصيد غير المستهلَك غير قابل للاسترداد (الشروط العامة، المادة 10.3).
الخصوصية#
- محتوى طلباتكم لا يُستخدم لتدريب النماذج.
- في استدعاءات المحادثة المتزامنة، لا تحفظ مسارات واجهة API محتوى الرسائل والصور؛ وتُسجّل بيانات الاستخدام. تُحذف الملفات المرفوعة عبر API الملفات بطلب مخصص، ولا تنتهي صلاحيتها تلقائيًا.
- أين تُعالَج بياناتكم وكيف يعمل حذفها : انظروا التخزين والخصوصية.
- لا تُرسلوا بيانات شخصية غير ضرورية في إدخالاتكم، ولا تستخدموا أبدًا بريدًا
إلكترونيًا أو هاتفًا كمعرّف
user: فضّلوا معرّفًا معتمًا.
الدعم#
| الحاجة | أين |
|---|---|
| سؤال تقني، عطل، طلب ميزة | Help & Feedback |
| شحن غير مُضاف للرصيد، فوترة | نفس الاستمارة، مع إرفاق مرجع التحويل |
| زيادة الحدود، أحجام كبيرة | نفس الاستمارة، مع تحديد حجمكم المستهدف |
| البريد الإلكتروني | support@cloudzir.com |
لأي خطأ، أرفقوا X-Request-Id والتوقيت الزمني UTC : هذا ما
يتيح إيجاد الأثر الدقيق.