وثائق API وMCP لكاشف الذكاء الاصطناعي

ابدأ هنا

البدء السريع

في لوحة تحكم API، جهّز المفتاح، وانسخه إلى مخزن آمن، وأكّد حفظه، ثم فعّله. بعد ذلك أرسل JSON عبر HTTPS. يستخدم هذا المثال Detector v3.

عنوان URL الأساسيhttps://api.detecting-ai.com

بدء سريع باستخدام cURL

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

حافظ على سرية المفاتيح الخاصة. خزّن المفتاح في متغير بيئة على الخادم أو في مدير أسرار. لا تضعه في حزمة متصفح أو تطبيق جوال أو مستودع عام أو لقطة شاشة أو مستند مشترك. لا تظهر القيمة كاملة إلا قبل التفعيل، ولا يمكن استعادتها بعد مغادرة الصفحة أو إعادة تحميلها. لا يؤثر تجهيز مفتاح بديل في المفتاح النشط، ولا يتغير المفتاح إلا عند تفعيل القيمة المحفوظة.

الوصول

المصادقة

يرسل REST وعملاء MCP المحليون مفاتيح API في ترويسات مختلفة. أما موصلات MCP المستضافة فتكتشف OAuth وتفتح مسار التفويض في المتصفح.

الواجهة	المصادقة	مثال
REST API	`X-API-Key`	`X-API-Key: YOUR_API_KEY`
موصل MCP مستضاف	`OAuth 2.0 مع PKCE`	`أضف عنوان URL الخاص بـ MCP فقط، ثم سجّل الدخول ووافق على منح الوصول`
عميل MCP محلي	`Authorization`	`Bearer YOUR_API_KEY`

سلامة الاستخدام

أعد محاولة طلب واحد دون الدفع مرتين

ينبغي أن ترسل التكاملات الجديدة Idempotency-Key فريدًا لكل طلب REST منطقي، وأن تحتفظ بالقيمة حتى ينجح الطلب أو تتخلى عنه. إذا انقطع الاتصال، فأعد المحاولة باستخدام نقطة النهاية والنص والإصدار أو النموذج والمفتاح نفسها تمامًا. تعيد المحاولة المطابقة الاستجابة المحفوظة من دون تشغيل مقدّم الخدمة أو خصم الكلمات مرة أخرى.

الترويسة	الحالة	البنية
`Idempotency-Key`	يوصى به بشدة	قيمة من 8–128 حرفًا، ومحارفها آمنة للاستخدام في URL. أنشئ قيمة عشوائية لكل عملية منطقية، واحتفظ بها عبر المحاولات.
`X-Idempotency-Key`	الاستجابة	يعيد مفتاح العميل المقبول أو مفتاح التوافق في الاستجابات الناجحة وعند فشل تسجيل الاستخدام.
`X-Idempotency-Key-Source`	استجابة التوافق	تكون قيمته server-generated فقط عندما يغفل طلب قديم ترويسة Idempotency-Key.

لا تعد استخدام مفتاح مع نص أو نقطة نهاية أو إصدار كاشف أو نموذج إعادة كتابة مختلف. يربط API هذه الحقول بالاستخدام الأول، ويعيد HTTP 409 عند عدم التطابق. يتلقى العملاء الحاليون الذين يغفلون الترويسة مفتاحًا عشوائيًا في X-Idempotency-Key، وقيمة X-Idempotency-Key-Source: server-generated. إذا فُقدت الاستجابة كاملة، فلا يمكن استعادة المفتاح المنشأ، وبالتالي لا يمكن إعادة الطلب بأمان. ينبغي للعملاء الجدد دائمًا إنشاء مفتاحهم وحفظه قبل الإرسال.

ما دام المستدعي الأول يحتفظ بحجز مقدّم الخدمة، تعيد المحاولة المتزامنة المطابقة HTTP 409 مع Retry-After. وبعد الاكتمال، تظل الاستجابة نفسها قابلة للإعادة لمدة 24 ساعة. وعند انتهاء صلاحية محتوى الاستجابة الخاص، يعيد المفتاح نفسه HTTP 410. ويبقى سجل دائم للعملية ليمنع احتسابها مرة ثانية.

نقطة نهاية REST

واجهة API لكاشف الذكاء الاصطناعي

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

POST/api/detect/

نص الطلب

حقل	النوع	مطلوب	الوصف
`text`	`string`	نعم	نص للتحليل.
`version`	`string`	نعم	v1، v2، أو v3. استخدم v3 للتكامل الجديد.

طلب الكاشف

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

الاستجابة

الكاشف v3

{
  "success": true,
  "data": {
    "details": {
      "chunks": [
        {
          "text": "A sentence from the input.",
          "startChar": 0,
          "endChar": 26,
          "type": "AI",
          "score": 0.87
        }
      ],
      "ai_percentage": 42.5
    },
    "version": "v3",
    "words_processed": 120
  }
}

اقرأ النتيجة بشكل صحيح. في بنية التوافق العامة لـ Detector v3، تمثل chunks جملًا مصنفة AI أو Human. وكل score هو مقدار ثقة مقدّم الخدمة من 0 إلى 1، وتحصل القيم الأعلى من 0.5 على تصنيف AI. أما ai_percentage الإجمالية فهي نسبة أحرف الإدخال التي تغطيها الجمل المصنفة AI، وليست متوسط درجات chunks. وتختلف هذه الطريقة عن منهجية الكاشف الأحدث في الموقع، لذلك لا تخلط بين هذه الحقول بضربها أو حساب متوسطاتها.

قراءة نظرة عامة على واجهة API لكاشف الذكاء الاصطناعي

تتطلب أداتا MCP وسيطة idempotency_key من 16–128 حرفًا، ومحارفها آمنة للاستخدام في URL. أنشئها لكل عملية مقصودة، ولا تعد استخدامها إلا للمحاولة نفسها بالضبط. لا يُستخدم معرّف طلب JSON-RPC مفتاحًا لعملية الفوترة.

نقطة نهاية REST

واجهة API لإضفاء الطابع البشري على النص

أعد كتابة النص المقدم باستخدام نموذج إعادة كتابة محدد. المخرجات قابلة للتحرير، وينبغي مراجعة المعنى والحقائق والأسماء والروابط والنبرة والمصطلحات المطلوبة.

POST/api/humanize/

نص الطلب

حقل	النوع	مطلوب	الوصف
`text`	`string`	نعم	نص لإعادة الكتابة.
`model`	`string`	نعم	cognia، lexi، cognia_v2، أو huma_v2.

طلب إضفاء الطابع البشري

curl --request POST \
  --url https://api.detecting-ai.com/api/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'

الاستجابة

استجابة إضفاء الطابع البشري

{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 120,
  "model_used": "cognia"
}

قراءة نظرة عامة على واجهة API لإضفاء الطابع البشري

نقطة نهاية REST

واجهة API لمدقق الانتحال

ابحث عن التداخل على مستوى الجملة وأرجع سياق المصدر عند العثور على تطابق. تحتاج المطابقة إلى مراجعة بشرية لأن الاقتباس والاستشهاد والإذن والصياغة القياسية تؤثر على ما تعنيه.

POST/api/plagiarism/

نص الطلب

حقل	النوع	مطلوب	الوصف
`text`	`string`	نعم	نص للتحقق من تداخل المصدر على مستوى الجملة.

طلب الانتحال

curl --request POST \
  --url https://api.detecting-ai.com/api/plagiarism/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: plagiarism-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to check."
  }'

الاستجابة

الرد على الانتحال

{
  "result": {
    "results": [
      {
        "sentence": "A sentence from the input.",
        "is_plagiarised": true,
        "web_sentence": "A similar source sentence.",
        "similarity": 91.0,
        "link": "https://example.com/source"
      }
    ],
    "plagiarism_score": 34.2
  },
  "words_processed": 120
}

النتيجة ليست شاملة. تمثل plagiarism_score نسبة أحرف الإدخال الواقعة داخل الجمل المميزة. يبحث المدقق في صفحات ويب مرشحة، ويعيد أول تطابق تقريبي مستوفٍ للشروط لكل جملة. ولا يثبت ذلك أن النص لم يظهر في مكان آخر.

قراءة نظرة عامة على واجهة API لمدقق الانتحال

Streamable HTTP

خادم MCP البعيد

يكشف خادم بعيد عن أداتين بالضبط: detect_ai_text وhumanize_text. التحقق من الانتحال متاح من خلال REST، وليس MCP.

MCPhttps://api.detecting-ai.com/api/mcp

أداة	الغرض	افتراضي
`detect_ai_text`	تحليل النص لإشارات الكتابة بالذكاء الاصطناعي والتفاصيل على مستوى الجملة.	`version: v3`
`humanize_text`	أعد كتابة النص المقدم وأرجع نتيجة قابلة للتحرير.	`model: cognia`

الموصلات المستضافة

أضف عنوان URL الخاص بـ MCP فقط في الموصل المستضاف. يكتشف العميل OAuth، ويفتح تسجيل الدخول والموافقة في المتصفح، ويخزن رموز المصادقة الخاصة به. لا تلحق مفتاح API أو أي بيانات اعتماد أخرى بعنوان URL.

Codex

إعداد Codex

export DETECTING_AI_API_KEY="YOUR_API_KEY"

[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300

Claude Code

أمر Claude Code

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

دليل MCP لكاشف الذكاء الاصطناعي دليل MCP لأداة إضفاء الطابع البشري

التعامل مع الفشل

أخطاء

تحقق من حالة HTTP ونص الاستجابة. لم يتم بعد تسوية حمولات الأخطاء في مخطط عالمي واحد.

الحالة	المعنى	ما يجب التحقق منه
`400`	طلب غير صالح أو رصيد الكلمات غير كافٍ	الحقول المطلوبة والإصدار أو النموذج المدعوم والكلمات المتاحة
`401`	المصادقة مفقودة أو غير صالحة	ترويسة X-API-Key في REST أو رمز Bearer في MCP
`403`	لا يوجد اشتراك نشط لهذه الميزة	حالة الخطة والوصول إلى المنتج المطلوب
`409`	العملية قيد التقدم بالفعل، أو تم إعادة استخدام المفتاح لأعمال مختلفة	التزم بقيمة Retry-After عند تكرار الطلب الجاري نفسه. إذا تغير text أو نقطة النهاية أو version أو model، فأنشئ مفتاحًا جديدًا.
`410`	العملية المكتملة أقدم من نافذة إعادة التشغيل الخاصة التي تبلغ 24 ساعة	لا تعد إرساله بوصفه العملية المنطقية نفسها. يبقى الاستخدام محسوبًا في السجل، ويُمنع التنفيذ المكرر.
`429`	تم الوصول إلى حد الطلب المؤقت	التزم بقيمة Retry-After وقلل تزامن الطلبات
`502`	فشل موفر التحليل المحدد بأمان	أعد المحاولة لاحقًا. لم يتم إرجاع أو تحصيل أي نتيجة ناجحة.
`503`	التحقق من الاشتراك أو تسجيل الاستخدام غير متاح	أعد الطلب نفسه تمامًا باستخدام Idempotency-Key ذاته. تحجب الخدمة مخرجات المزوّد عندما يتعذر التأكد من إتمام العملية.

يبقى توافق أخطاء الحصة الحالي في المستوى الأعلى. عند عدم وجود اشتراك نشط، يعيد النظام HTTP 403 مع error_code: "1002". وعند عدم كفاية الكلمات، يعيد HTTP 400 مع حقل error القديم وحقول الرصيد المنظمة.

الحصص والحدود

الاستخدام والحدود

يُحتسب الاستخدام من عدد كلمات الإدخال المفصولة بمسافات بيضاء. ولكل من الكاشف وأداة إضفاء الطابع البشري ومدقق الانتحال رصيد مستقل، حتى عندما يصل المفتاح نفسه إلى أكثر من منتج.

تحقق من الكلمات المتبقية والخطط النشطة في لوحة تحكم API.
يستخدم MCP رصيد الكاشف أو أداة إضفاء الطابع البشري نفسه الذي تستخدمه REST API المطابقة.
الحد الافتراضي للنص في REST وMCP هو 160,000 حرف. ولدى MCP أيضًا حد 1 MiB لحجم محتوى النقل. قسّم المستندات الكبيرة جدًا إلى أقسام مترابطة.

جاهز للدمج

أرسل طلبك الأول من خادم موثوق

أنشئ مفتاحًا، واختر نقطة النهاية التي تطابق المهمة، واختبر الاستجابات الناجحة وغير الناجحة قبل إضافة واجهة المستخدم.

افتح لوحة تحكم API قارن الخطط

واجهة API لكاشف الذكاء الاصطناعي ووثائق MCP

البدء السريع

المصادقة

أعد محاولة طلب واحد دون الدفع مرتين

واجهة API لكاشف الذكاء الاصطناعي

نص الطلب

الاستجابة

واجهة API لإضفاء الطابع البشري على النص

نص الطلب

الاستجابة

واجهة API لمدقق الانتحال

نص الطلب

الاستجابة

خادم MCP البعيد

الموصلات المستضافة

Codex

Claude Code

أخطاء

الاستخدام والحدود

أرسل طلبك الأول من خادم موثوق