API متاح

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

وثائق المطور

الإصدار 1: اكتشاف الذكاء الاصطناعي وإضفاء الطابع الإنساني عليه باستخدام الاعتمادات المدفوعة مسبقًا.

التوفر

الإنتاج API مفتوح. مطلوب حساب تم التحقق منه ومفتاح API والاعتمادات المتاحة وقدرة المعالجة. حدود السعة المؤقتة ترجع 503 قبل المعالجة؛ أعد المحاولة لاحقًا بنفس معرف الطلب.

الاتصال الدعم بشأن التكامل الخاص بك. لا يتم إجراء أي عملية شراء أو طلب لـ API من خلال هذه الوثائق.

المصادقة

استخدم مفتاح Check AI في إذن رأس من الخادم الخاص بك. لا تضعه أبدًا في حزمة متصفح أو مستودع عام أو رسالة دعم. عنوان URL الأساسي: https://checkai-app.com.

Authorization: Bearer YOUR_CHECKAI_API_KEY

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

نقاط النهاية

الإصدار 1 - الوصول الموثق
الطريقة والمسار	الغرض	الاعتمادات
`بوست /api/v1/detect`	نتيجة الكشف والمقاطع المحددة وشرحها	1 لكل كلمة إدخال
`POST /api/v1/إنسانية`	إعادة كتابة النص	4 لكل كلمة إدخال
`الحصول على /api/v1/balance`	available_credits and reserved_credits	لا الاعتمادات المعالجة
`الحصول على /api/v1/requests/{id}`	حالة الطلب والنتيجة المحفوظة	لا الاعتمادات المعالجة

إرسال JSON مع واحد نص سلسلة. يقبل الاكتشاف 30-2000 كلمة؛ أنسنة تقبل 10-2000. كلاهما يقتصر على 20000 حرف. يتم حساب الكلمات عن طريق تقسيم النص المقطوع على مسافة بيضاء. لا يتم دعم إعدادات التحميل والبث وإعادة الكتابة المخصصة.

طلب أمثلة

تتطلب هذه الأمثلة تمكين API ومفتاحًا حقيقيًا. زر النسخ ينسخ النص فقط.

# Server-side request; requires a valid key and credits.
curl https://checkai-app.com/api/v1/humanize \
  -H "Authorization: Bearer YOUR_CHECKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{"text":"Clear writing starts with one useful idea and a careful review."}'

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

مثال على الاستجابة الإنسانية

{
  "request_id": "example-request-id",
  "status": "succeeded",
  "usage": {
    "input_words": 12,
    "credits": 48
  },
  "result": {
    "text": "Good writing begins with a useful idea, followed by careful editing."
  }
}

رد توضيحي. يعود الكشف result.ai_percentage (0–100), result.highlights (مقاطع نصية) و result.explanation.

الاعتمادات وإعادة المحاولة

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

كل مشاركة تتطلب العجز-مفتاح: 16-128 حرفًا أو رقمًا أو شرطات سفلية أو واصلات. استخدم معرفًا واحدًا لكل طلب منطقي. يؤدي التكرار المتطابق إلى إرجاع حالته المحفوظة دون استدعاء موفر ثانٍ. تؤدي إعادة استخدامه بنص مختلف أو أداة مختلفة إلى إرجاع 409.

تتضمن الاستجابة 202 معرف الطلب. التحقق من ذلك باستخدام GET؛ لا تقدم مرة أخرى تحت مفتاح جديد. اتصل بالدعم إذا ظل الأمر معلقًا. النتائج متاحة لمدة سبعة أيام. وبعد ذلك، يُرجع الطلب الناجح 410 ولا يتم إعادة تقديمه تلقائيًا أبدًا.

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

الأخطاء والحدود

على الأكثر طلبان للمعالجة لم يتم حلهما و30 طلب معالجة جديدًا في الدقيقة لكل حساب. تنطبق حدود الحساب والمفتاح وIP الإضافية. يطلب الموفر المهلة بعد 30 ثانية؛ السماح 45 ثانية على الأقل في العميل الخاص بك.

202: معلق أو غير مؤكد — تحقق من معرف الطلب
400 / 415: نص غير صالح أو مفتاح Idempotency أو نوع محتوى JSON
401 / 403: مفتاح غير صالح، أو حساب لم يتم التحقق منه أو غير متاح
402: رصيد API غير كافٍ
409: تعارض العجز أو طلبين لم يتم حلهما
410: انتهت صلاحية النتيجة المحفوظة؛ لا تكرار المعالجة
429: حد السعر - انتظر قبل إعادة المحاولة
502: الرفض المؤكد؛ عادت الاعتمادات
503: API مغلق أو التخزين غير متوفر أو استنفاد القدرة على المعالجة

النص والخصوصية

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

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

لا يمكن لاكتشاف الذكاء الاصطناعي إثبات التأليف بشكل مؤكد. إعادة الكتابة لا تضمن الدقة الفعلية أو الأصالة أو التصنيف البشري بواسطة أي كاشف.