cicora.ai
العربية
مواصفات APIالبدء

البدء السريع

أرسل طلبًا أول، واختر نموذجًا من الكتالوج، واحتفظ بمعرّف طلب للتشخيص.

حزمة SDK بأسلوب OpenAI وcurlhttps://cicora.ai/api/v1
حزمة Messages SDK وClaude Codehttps://cicora.ai/api

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

1. إعداد البيئة

احتفظ بالمفتاح في متغير بيئة أو مخزن أسرار فقط. يجب ألا تحتوي تعليمات المتصفح البرمجية عليه أو تكتبه في السجلات.

عنوان URL الأساسي للتكامل هو https://cicora.ai/api/v1. يضيف كل مثال أدناه مساره إلى هذا العنوان الأساسي.

الطلب الأول
bash
export CICORA_API_KEY=replace_with_your_key

curl --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "messages": [{"role": "user", "content": "Explain this API in one sentence."}]
  }'

2. تكوين الطلب

  • استخدم معرّف النموذج الدقيق الذي يعيده الكتالوج.
  • أرسل الرسائل بترتيب المحادثة: system ثم user ثم assistant ثم tool عند الحاجة.
  • ابدأ بتباين أقل، ثم اضبط المعلمات للمهمة.

3. معالجة الاستجابة

اقرأ النص من أول عنصر استجابة متاح واحفظ معرّف الطلب إلى جانب معرّف الأثر الخاص بك.

تحقق من الحالة وبنية الخطأ قبل إعادة المحاولة. أعد محاولة العمليات التي يستطيع تطبيقك منع تكرار العمل فيها فقط.

تابع القراءة