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.
https://api.detecting-ai.comcurl --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.
| Interfeys | Autentifikatsiya | Misol |
|---|---|---|
| REST API | X-API-Key | X-API-Key: YOUR_API_KEY |
| Xostdagi MCP ulagichi | OAuth 2.0 PKCE bilan | Faqat MCP URL manzilini qoʻshing, keyin tizimga kiring va ruxsatni tasdiqlang |
| Mahalliy MCP mijozi | Authorization | Bearer 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.
| Sarlavha | Holat | Shartnoma |
|---|---|---|
Idempotency-Key | Juda tavsiya etiladi | 8–128 URL uchun xavfsiz belgilar. Har bir mantiqiy operatsiya uchun tasodifiy qiymat yarating va uni qayta urinishlar davomida saqlab qoling. |
X-Idempotency-Key | Javob | Muvaffaqiyatli javoblarda va sarfni yozish xatolarida qabul qilingan mijoz kaliti yoki moslik kalitini aks ettiradi. |
X-Idempotency-Key-Source | Moslik javobi | Faqat 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.
/api/detect/Soʻrov tanasi
| Maydon | Turi | Majburiy | Tavsif |
|---|---|---|---|
text | string | Ha | Tahlil qilish uchun matn. |
version | string | Ha | v1, v2 yoki v3. Yangi integratsiya uchun v3 dan foydalaning. |
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
{
"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.
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.
/api/humanize/Soʻrov tanasi
| Maydon | Turi | Majburiy | Tavsif |
|---|---|---|---|
text | string | Ha | Qayta yozish uchun matn. |
model | string | Ha | cognia, lexi, cognia_v2 yoki 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"
}'Javob
{
"humanized_text": "The rewritten text is returned here.",
"words_processed": 120,
"model_used": "cognia"
}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.
/api/plagiarism/Soʻrov tanasi
| Maydon | Turi | Majburiy | Tavsif |
|---|---|---|---|
text | string | Ha | Matn jumlalar darajasidagi manbalarning oʻxshashligini tekshirish uchun. |
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
{
"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.
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.
https://api.detecting-ai.com/api/mcp| Asbob | Maqsad | Birlamchi |
|---|---|---|
detect_ai_text | SI yozish signallari va jumlalar darajasidagi tafsilotlar uchun matnni tahlil qiling. | version: v3 |
humanize_text | Taqdim 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
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 = 300Claude Code
claude mcp add --transport http --scope user \
--header "Authorization: Bearer YOUR_API_KEY" \
detecting-ai https://api.detecting-ai.com/api/mcpMuvaffaqiyatsizlik
Xatolar
HTTP holati va javob tanasini birga tekshiring. Xato javoblari hali yagona universal sxemaga keltirilmagan.
| Holat | Maʻnosi | Nimani tekshirish kerak |
|---|---|---|
400 | Soʻrov notoʻgʻri yoki soʻz balansi yetarli emas | Talab qilinadigan maydonlar, qoʻllab-quvvatlanadigan versiya yoki model va mavjud soʻzlar |
401 | Autentifikatsiya etishmayapti yoki yaroqsiz | REST uchun X-API-Key sarlavhasi yoki MCP uchun bearer token |
403 | Xususiyatlar uchun faol obuna yoʻq | Reja holati va soʻralgan mahsulotga kirish |
409 | Operatsiya davom etmoqda yoki kalit boshqa operatsiyada qayta ishlatilgan | Ayni soʻrov hali bajarilayotgan boʻlsa, Retry-After sarlavhasiga rioya qiling. Oʻzgartirilgan matn, endpoint, versiya yoki model uchun yangi kalit yarating. |
410 | Yakunlangan operatsiyaning yopiq takrorlash muddati 24 soatdan oshgan | Uni ayni mantiqiy operatsiya sifatida qayta yubormang. Doimiy qayd takroriy bajarilish va ikkinchi marta haq yechilishining oldini oladi. |
429 | Vaqtinchalik soʻrov chegarasiga yetdi | Retry-After sarlavhasiga rioya qiling va parallel soʻrovlar sonini kamaytiring |
502 | Tanlangan tahlil provayderi xavfsiz bajarilmadi | Keyinroq qayta urining. Muvaffaqiyatli natija qaytarilmadi va haq yechilmadi. |
503 | Obunani tekshirish yoki foydalanishni yozib boʻlmaydi | Aynan 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.