cicora.ai
مواصفات APIواجهة سطر الأوامر والتطبيقات

واجهة سطر الأوامر وعمليات التكامل

اضبط عميلًا بمفتاح ونموذج وعنوان URL أساسي يطابق بروتوكوله؛ وأبقِ السر في البيئة.

مرجع التكامل: اختر المعلمات والإمكانات المتاحة من إعدادات API لحسابك ومن كتالوج النماذج لبيئتك.

اختيار عنوان URL المتوافق

لعميل بأسلوب OpenAI، اضبط CICORA_API_BASE_URL=https://cicora.ai/api/v1 ولا تضف /v1 ثانية.

لعميل Messages أو Claude Code، اضبط ANTHROPIC_BASE_URL=https://cicora.ai/api: يضيف هذا العميل /v1/messages بنفسه. تحقق من الإعداد عبر كتالوج النماذج قبل الاستدلال.

إعداد عميل متوافق
bash
export CICORA_API_BASE_URL=https://cicora.ai/api/v1
export CICORA_API_KEY=replace_with_your_key

curl "$CICORA_API_BASE_URL/models" \
  --header "Authorization: Bearer $CICORA_API_KEY"

إطلاق آمن

  • مرر متغيرات البيئة عبر مدير أسرار أو ملف تعريف آمن.
  • استبعد ملفات .env والإعدادات المصدّرة من عمليات الحفظ في المستودع.
  • امنح كل تطبيق مفتاحًا خاصًا به كي يمكن إلغاء الوصول من دون إيقاف التطبيقات الأخرى.

عقد قابل للنقل

احتفظ بسجلات الطلبات والاستجابات من دون Authorization أو بيانات المستخدم عندما يسمح نظام الاحتفاظ لديك بذلك.

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