Ishlab chiquvchi hujjatlari

Sunʻiy intellekt detektori API va MCP hujjatlari

Sunʻiy intellekt detektori, SI matnini tabiiylashtirish va plagiatni tekshirish REST APIlariga JSON yuboring yoki masofaviy MCP serverini mos yordamchiga ulang. Quyidagi misollarda ishlab chiqarish muhiti xost nomi va joriy API shartnomasi ishlatiladi.

Shu yerdan boshlang

Tez ishga tushirish

API asboblar panelida kalit tayyorlang, uni xavfsiz doʻkonga nusxalang, saqlanganligini tasdiqlang va uni faollashtiring. Keyin JSON ni HTTPS orqali yuboring. Bu misolda detektor v3 ishlatiladi.

Asosiy URLhttps://api.detecting-ai.com
cURL tezkor ishga tushirish
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"
  }'

Shaxsiy kalitlarni maxfiy saqlang. Kalitni server tomonidagi muhit oʻzgaruvchisida yoki maxfiy saqlash tizimida saqlang. Uni brauzer toʻplamiga, mobil ilova binar fayliga, ochiq repozitoriyga, skrinshotga yoki umumiy hujjatga qoʻymang. Toʻliq qiymat faqat faollashtirishdan oldin koʻrsatiladi, sahifadan chiqqach yoki uni qayta yuklagach tiklab boʻlmaydi. Almashtirish uchun yangi qiymat tayyorlash faol kalitni toʻxtatmaydi. Kalit faqat saqlangan qiymatni faollashtirganingizda oʻzgaradi.

Kirish

Autentifikatsiya

REST soʻrovlari va mahalliy MCP mijozlari API kalitini turli sarlavhalarda yuboradi. Xostdagi MCP ulagichlari OAuth xizmatini topib, brauzerdagi avtorizatsiya jarayonini ochadi.

InterfeysAutentifikatsiyaMisol
REST APIX-API-KeyX-API-Key: YOUR_API_KEY
Xostdagi MCP ulagichiOAuth 2.0 PKCE bilanFaqat MCP URL manzilini qoʻshing, keyin tizimga kiring va ruxsatni tasdiqlang
Mahalliy MCP mijoziAuthorizationBearer YOUR_API_KEY

Foydalanish xavfsizligi

Bitta soʻrov uchun ikki marta haq toʻlamasdan qayta urining

Yangi integratsiya har bir mantiqiy REST soʻrovi uchun noyob Idempotency-Key yuborishi va soʻrov yakunlanmaguncha yoki undan voz kechilmaguncha bu qiymatni saqlashi kerak. Ulanish uzilsa, aynan oʻsha endpoint, matn, versiya yoki model va kalit bilan qayta urining. Aynan bir xil takroriy soʻrov provayderni qayta ishga tushirmasdan va soʻzlarni yana yechmasdan saqlangan javobni qaytaradi.

SarlavhaHolatShartnoma
Idempotency-KeyJuda tavsiya etiladi8–128 URL uchun xavfsiz belgilar. Har bir mantiqiy operatsiya uchun tasodifiy qiymat yarating va uni qayta urinishlar davomida saqlab qoling.
X-Idempotency-KeyJavobMuvaffaqiyatli javoblarda va sarfni yozish xatolarida qabul qilingan mijoz kaliti yoki moslik kalitini aks ettiradi.
X-Idempotency-Key-SourceMoslik javobiFaqat eski mijoz Idempotency-Key yubormaganda server-generated qiymatiga oʻrnatiladi.

Kalitni oʻzgartirilgan matn, endpoint, detektor versiyasi yoki tabiiylashtirish modeli bilan hech qachon qayta ishlatmang. API bu maydonlarni birinchi foydalanishdagi qiymatlarga bogʻlaydi va mos kelmasa HTTP 409 qaytaradi. Sarlavhani yubormaydigan eski mijozlar X-Idempotency-Key ichida tasodifiy kalit va X-Idempotency-Key-Source: server-generated sarlavhasini oladi. Javob butunlay yoʻqolsa, server yaratgan kalitni tiklab boʻlmaydi, demak soʻrovni xavfsiz qayta urinish ham mumkin emas. Yangi mijozlar yuborishdan oldin har doim oʻz kalitini yaratib, saqlashi kerak.

Birinchi soʻrov provayder ishini bajarayotgan paytda bir vaqtdagi takroriy urinish HTTP 409 va Retry-After sarlavhasini qaytaradi. Operatsiya tugagach, ayni javob 24 soat davomida qayta beriladi. Bu yopiq javob tanasining muddati tugagach, oʻsha kalit HTTP 410 qaytaradi. Doimiy qayd esa ikkinchi marta haq yechilishining oldini oladi.

REST endpointi

Sunʻiy intellekt detektori API

Yuborilgan matnni SI yozuviga xos naqshlar boʻyicha tahlil qiling. Natija mualliflik isboti emas, balki ehtimoliy tekshiruv signalidir.

POST/api/detect/

Soʻrov tanasi

MaydonTuriMajburiyTavsif
textstringHaTahlil qilish uchun matn.
versionstringHav1, v2 yoki v3. Yangi integratsiya uchun v3 dan foydalaning.
Detektor soʻrovi
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"
  }'

Javob

Detektor v3 javobi
{
  "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
  }
}

Ballni toʻgʻri oʻqing. Ommaviy Detector v3 moslik shartnomasida boʻlaklar jumla darajasida boʻladi va AI yoki Human deb belgilanadi. Har bir boʻlakning score qiymati provayderning 0 dan 1 gacha boʻlgan ishonch koʻrsatkichidir. 0,5 dan yuqori qiymat AI belgisini oladi. Umumiy ai_percentage esa boʻlak ballarining oʻrtachasi emas, AI deb belgilangan jumlalar qamrab olgan kirish belgilarining foizidir. Bu yangi veb-sayt detektori metodologiyasidan farq qiladi, shuning uchun maydonlarni bir-birining oʻrnida ishlatmang, 100 ga koʻpaytirmang va oʻrtachasini hisoblamang.

Sunʻiy intellekt detektori API sharhini oʻqish

Har ikkala MCP vositasi URL uchun xavfsiz, 16–128 belgili idempotency_key argumentini talab qiladi. Har bir ataylab boshlangan vosita chaqiruvi uchun yangi kalit yarating va uni faqat aynan bir xil qayta urinishda ishlating. JSON-RPC soʻrov identifikatori toʻlov operatsiyasi kaliti sifatida ishlatilmaydi.

REST endpointi

SI matnini tabiiylashtirish API

Yuborilgan matnni tanlangan tabiiylashtirish modeli bilan qayta yozing. Natijani tahrirlash mumkin, ammo maʻno, faktlar, ismlar, havolalar, ohang va zarur terminologiya tekshirilishi kerak.

POST/api/humanize/

Soʻrov tanasi

MaydonTuriMajburiyTavsif
textstringHaQayta yozish uchun matn.
modelstringHacognia, lexi, cognia_v2 yoki huma_v2.
Tabiiylashtirish soʻrovi
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"
  }'

Javob

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

SI matnini tabiiylashtirish API sharhini oʻqish

REST endpointi

Plagiat tekshiruvi API

Jumla darajasidagi oʻxshashliklarni qidiring va moslik topilsa, manba kontekstini qaytaring. Natijani inson tekshirishi kerak, chunki koʻchirma, manba koʻrsatish, ruxsat va odatiy iboralar moslik maʻnosiga taʻsir qiladi.

POST/api/plagiarism/

Soʻrov tanasi

MaydonTuriMajburiyTavsif
textstringHaMatn jumlalar darajasidagi manbalarning oʻxshashligini tekshirish uchun.
Plagiat soʻrovi
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."
  }'

Javob

Plagiat javobi
{
  "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
}

Baho toʻliq emas. plagiarism_score belgilangan jumlalar qamrab olgan kirish belgilarining ulushidir. Tekshiruvchi ehtimoliy manba veb-sahifalarini qidiradi va har bir jumla uchun birinchi taxminiy moslikni qaytaradi. Bu matn boshqa joyda hech qachon uchramaganini isbotlamaydi.

Plagiat tekshiruvi API sharhini oʻqish

Streamable HTTP

Masofaviy MCP server

Bitta masofaviy server aniq ikkita vositani ochib beradi: detect_ai_text va humanize_text. Plagiatni tekshirish MCP emas, REST orqali amalga oshiriladi.

MCPhttps://api.detecting-ai.com/api/mcp
AsbobMaqsadBirlamchi
detect_ai_textSI yozish signallari va jumlalar darajasidagi tafsilotlar uchun matnni tahlil qiling.version: v3
humanize_textTaqdim etilgan matnni qayta yozing va tahrirlanadigan natijani qaytaring.model: cognia

Xostdagi ulagichlar

Xostdagi ulagichga faqat MCP URL manzilini qoʻshing. Mijoz OAuth xizmatini topadi, brauzerda kirish va rozilik oynasini ochadi hamda tokenlarni oʻzi saqlaydi. URL manziliga API kaliti yoki boshqa hisob maʻlumotlarini qoʻshmang.

Codex

Codex konfiguratsiyasi
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 buyrugʻi
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

Muvaffaqiyatsizlik

Xatolar

HTTP holati va javob tanasini birga tekshiring. Xato javoblari hali yagona universal sxemaga keltirilmagan.

HolatMaʻnosiNimani tekshirish kerak
400Soʻrov notoʻgʻri yoki soʻz balansi yetarli emasTalab qilinadigan maydonlar, qoʻllab-quvvatlanadigan versiya yoki model va mavjud soʻzlar
401Autentifikatsiya etishmayapti yoki yaroqsizREST uchun X-API-Key sarlavhasi yoki MCP uchun bearer token
403Xususiyatlar uchun faol obuna yoʻqReja holati va soʻralgan mahsulotga kirish
409Operatsiya davom etmoqda yoki kalit boshqa operatsiyada qayta ishlatilganAyni soʻrov hali bajarilayotgan boʻlsa, Retry-After sarlavhasiga rioya qiling. Oʻzgartirilgan matn, endpoint, versiya yoki model uchun yangi kalit yarating.
410Yakunlangan operatsiyaning yopiq takrorlash muddati 24 soatdan oshganUni ayni mantiqiy operatsiya sifatida qayta yubormang. Doimiy qayd takroriy bajarilish va ikkinchi marta haq yechilishining oldini oladi.
429Vaqtinchalik soʻrov chegarasiga yetdiRetry-After sarlavhasiga rioya qiling va parallel soʻrovlar sonini kamaytiring
502Tanlangan tahlil provayderi xavfsiz bajarilmadiKeyinroq qayta urining. Muvaffaqiyatli natija qaytarilmadi va haq yechilmadi.
503Obunani tekshirish yoki foydalanishni yozib boʻlmaydiAynan oʻsha soʻrovni bir xil Idempotency-Key bilan qayta urining. Natijaning yakuniyligi noaniq boʻlsa, xizmat provayder chiqishini mijozga bermaydi.

Eski kvota xatolari bilan moslik uchun maydonlar javobning yuqori darajasida saqlanadi. Faol obuna boʻlmasa, error_code: "1002" bilan HTTP 403 qaytariladi. Soʻzlar yetarli boʻlmasa, eski xato maydoni va tuzilgan balans maydonlari bilan HTTP 400 qaytariladi.

Kvota va chegaralar

Foydalanish va cheklovlar

Sarf kirish matnidagi boʻsh joy bilan ajratilgan soʻzlar soni boʻyicha hisoblanadi. Hatto bitta kalit bir nechta mahsulotga ruxsat bersa ham, detektor, matnni tabiiylashtirish va plagiat balanslari alohida yuritiladi.

  • Qolgan soʻzlar va faol rejalarni API asboblar panelida tekshiring.
  • MCP mos REST API bilan bir xil detektor yoki matnni tabiiylashtirish balansidan foydalanadi.
  • REST va MCP uchun standart matn chegarasi 160 000 belgi. MCP transport tanasi uchun ham 1 MiB cheklov bor. Juda katta hujjatlarni mazmunli boʻlimlarga ajrating.

Integratsiyaga tayyor

Ishonchli serverdan birinchi soʻrovni qiling

Kalit yarating, vazifaga mos endpointni tanlang va interfeys qoʻshishdan oldin muvaffaqiyatli hamda xato javoblarni sinang.