> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# اكتشاف التزييف العميق وانتحال الشخصية

> تقييم مؤشرات التزييف العميق وانتحال الشخصية المقدمة أو النتائج الخارجية، وتوجيه نتائج العتبة إلى إشارات المخاطر.

> [!WARNING]
>
> لا يقوم نقطة النهاية هذه بتنزيل أو فحص الصورة أو الفيديو أو المستند المشار إليه. بل تقوم بتقييم المؤشرات أو الدرجات المقدمة من تطبيقك. القيم هي درجات مخاطر استدلالية، وليست احتمالات معايرة. تشير التسمية `authentic` إلى أن عتبة المخاطر المكونة لم يتم الوصول إليها؛ وهي ليست دليلاً على أن الوسائط أصلية، خاصة عندما لم يتم توفير أي مؤشرات.

تقوم واجهة برمجة تطبيقات التزييف العميق وانتحال الشخصية بتقييم المؤشرات أو الدرجات الخارجية التي يوفرها تطبيقك لموضوع مشار إليه. لا تقوم بفحص الوسائط أو المستند المشار إليه. النتائج التي تتجاوز عتبة المخاطر تنشئ تلقائيًا [إشارة مخاطر](https://docs.truthlocks.com/ar/guides/risk-signals.md)، لربط دليل الكشف الخاص بك في المنبع بخط أنابيب جدار الحماية للهوية لمكافحة الاحتيال.

> [!NOTE]
>
> يعد اكتشاف التزييف العميق جزءًا من [جدار حماية الهوية لمكافحة الاحتيال](https://docs.truthlocks.com/ar/guides/risk-signals.md). تتدفق نتائج الفحص إلى نفس مسار إشارة المخاطر مثل إشارات الاحتيال الأخرى، بحيث يمكنك الاستعلام عنها ومراجعتها من صفحة وحدة التحكم **المخاطر والاحتيال > الإشارات** أو [نقطة نهاية قائمة الإشارات](https://docs.truthlocks.com/ar/api-reference/risk-signals/list.md).

## كيف يعمل

**1. تقديم مسح ضوئي**

أرسل طلب `POST` إلى `/v1/risk/deepfake/scan` مع مرجع موضوع وإما إشارات مؤشر خام من خط أنابيب الكشف الخاص بك أو درجات محسوبة مسبقًا من نموذج خارجي.

**2. مراجعة الحكم**

يتضمن الرد درجات التزييف العميق وانتحال الشخصية (0-100) وحكمًا: `authentic`، `suspect`، `deepfake`، أو `impersonation`.

**3. إنشاء إشارة تلقائية**

عندما تصل النتيجة إلى 60 أو أعلى، تقوم المنصة تلقائيًا بإدخال إشارة مخاطر في مسار عمل المستأجر الخاص بك. تتضمن الاستجابة `signal_id` حتى تتمكن من تتبعها.

**4. استرداد النتائج لاحقًا**

استخدم `GET /v1/risk/deepfake/results/{subject_ref}` لجلب أحدث نتيجة مسح لأي موضوع تم مسحه مسبقًا.

## المتطلبات الأساسية

* مستأجر Truthlocks نشط مع مفتاح API
* مراجع الموضوع للمحتوى الذي تريد مسحه ضوئيًا (عناوين URL، تجزئات SHA-256، معرفات الشهادات، أو معرفات مبهمة)

## فحص موضوع

إرسال مسح مع إشارات مؤشر من خط أنابيب الكشف الخاص بك:

```bash cURL theme={null}
curl -X POST https://api.truthlocks.com/v1/risk/deepfake/scan \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject_ref": "sha256:a1b2c3d4...",
    "subject_type": "image",
    "signals": ["face_swap_detected", "inconsistent_lighting"]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.truthlocks.com/v1/risk/deepfake/scan", {
  method: "POST",
  headers: {
    "X-API-Key": "tl_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    subject_ref: "sha256:a1b2c3d4...",
    subject_type: "image",
    signals: ["face_swap_detected", "inconsistent_lighting"],
  }),
});
const result = await response.json();
```

```python Python theme={null}
import httpx

resp = httpx.post(
    "https://api.truthlocks.com/v1/risk/deepfake/scan",
    headers={"X-API-Key": "tl_live_..."},
    json={
        "subject_ref": "sha256:a1b2c3d4...",
        "subject_type": "image",
        "signals": ["face_swap_detected", "inconsistent_lighting"],
    },
)
result = resp.json()
```

يتضمن الرد الدرجات، والحكم، و (إذا تم استيفاء العتبة) إشارة مخاطر مرتبطة:

```json theme={null}
{
  "scan_id": "7c8d9e0f-...",
  "subject_ref": "sha256:a1b2c3d4...",
  "subject_type": "image",
  "deepfake_score": 60,
  "impersonation_score": 0,
  "verdict": "suspect",
  "indicators": ["face_swap_detected", "inconsistent_lighting"],
  "detection_model": "heuristic_v1",
  "signal_id": "9f3a1c2d-...",
  "created_at": "2027-05-22T10:00:00Z"
}
```

## نموذج الكشف

تستخدم المنصة محرك إشارات استدلالي (`heuristic_v1`) يقوم بتعيين المؤشرات المقدمة من المتصل إلى درجات مرجحة. يقوم المحرك بتقييم 12 مؤشرًا عبر فئتين:

### مؤشرات التزييف العميق

| المؤشر | الوصف |
| :- | :- |
| `face_swap_detected` | تم اكتشاف استبدال الوجه أو تحويله |
| `inconsistent_lighting` | عدم اتساق الإضاءة عبر الموضوع |
| `compression_artifacts` | أنماط ضغط غير عادية تشير إلى التلاعب |
| `temporal_inconsistency` | تناقضات على مستوى الإطار في محتوى الفيديو |
| `metadata_mismatch` | بيانات تعريف الملف لا تتطابق مع الأنماط المتوقعة |

### مؤشرات انتحال الشخصية

| المؤشر | الوصف |
| :- | :- |
| `biometric_mismatch` | البيانات البيومترية لا تتطابق مع الهوية المدعاة |
| `name_mismatch` | الاسم على وثيقة الهوية لا يتطابق مع السجلات |
| `identity_doc_mismatch` | وثيقة الهوية تبدو معدلة أو غير متناسقة |
| `issuer_trust_violation` | مستوى ثقة المصدر غير كافٍ للمطالبة |

## الأحكام والعتبات

ينتج عن كل فحص حكم بناءً على أعلى درجة:

| نطاق الدرجات | الحكم | المعنى |
| :- | :- | :- |
| 0 – 39 | `authentic` | لم يتم الكشف عن مؤشرات مهمة |
| 40 – 74 | `suspect` | توجد بعض المؤشرات - يوصى بالمراجعة |
| 75 – 100 | `deepfake` أو `impersonation` | اكتشاف بثقة عالية — يعتمد الحكم على النتيجة السائدة |

عندما يصل أي من النتيجتين إلى **60 أو أعلى**، تقوم المنصة تلقائيًا بإنشاء إشارة خطر. لا تحتاج إلى إجراء استدعاء API منفصل — يتم إرجاع `signal_id` في استجابة الفحص.

## استخدام النتائج المحسوبة مسبقًا

إذا كان لديك بالفعل درجات من نموذج تعلم آلي خارجي أو خدمة اكتشاف، فمررها مباشرة لتخطي التحليل الاستدلالي:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/risk/deepfake/scan \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject_ref": "sha256:a1b2c3d4...",
    "subject_type": "video",
    "deepfake_score": 82,
    "impersonation_score": 15
  }'
```

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

## ربط عمليات المسح بالشهادات

ربط مسح بإشهاد موجود لربط نتائج الكشف ببيانات الاعتماد التي تتعلق بها:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/risk/deepfake/scan \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject_ref": "sha256:a1b2c3d4...",
    "subject_type": "attestation",
    "signals": ["biometric_mismatch", "identity_doc_mismatch"],
    "attestation_id": "660e8400-e29b-41d4-a716-446655440001"
  }'
```

هذا يجعل من السهل وضع علامة على الشهادات المشبوهة ومراجعتها في وحدة التحكم.

## استرداد نتائج الفحص

جلب أحدث نتيجة مسح لموضوع دون إعادة تشغيل المسح:

```bash theme={null}
curl https://api.truthlocks.com/v1/risk/deepfake/results/sha256:a1b2c3d4... \
  -H "X-API-Key: tl_live_..."
```

## أنواع الموضوعات

يحدد حقل `subject_type` نوع المحتوى الذي يتم مسحه ضوئيًا للمنصة:

| النوع | حالة الاستخدام |
| :- | :- |
| `image` | صور، وثائق هوية، صور ملف شخصي |
| `video` | تسجيلات الفيديو، اللقطات الحية |
| `document` | ملفات PDF، مستندات ممسوحة ضوئيًا |
| `attestation` | بيانات الاعتماد الصادرة من خلال المنصة |
| `identity` | مطالبات الهوية، طلبات KYC |

## قياس الاستخدام

تزيد كل طلب مسح للصور المزيفة عداد استخدام `antifraud.deepfake_scans` لدورة الفوترة الخاصة بك. يمكنك مراقبة استهلاك المسح الخاص بك باستخدام [واجهة برمجة تطبيقات الاستخدام](https://docs.truthlocks.com/ar/api-reference/billing/usage.md) أو في وحدة التحكم ضمن **الإعدادات > الفوترة > الاستخدام** في قسم **مكافحة الاحتيال**.

> [!NOTE]
>
> تختلف حصص فحص التزييف العميق حسب مستوى الخطة. راجع [نظرة عامة على الفواتير](https://docs.truthlocks.com/ar/billing/overview.md#metered-products) للحصول على تفاصيل حول جميع منتجات مكافحة الاحتيال المقاسة.

## ما التالي

* [مرجع API لمسح التزييف العميق](https://docs.truthlocks.com/ar/api-reference/risk/deepfake-scan.md)
* [مرجع API للحصول على نتائج المسح](https://docs.truthlocks.com/ar/api-reference/risk/deepfake-results.md)
* [دليل اكتشاف الاستيلاء على الحساب](https://docs.truthlocks.com/ar/guides/ato-detection.md)
* [دليل السرعة وتسجيل الشذوذ](https://docs.truthlocks.com/ar/guides/velocity-scoring.md)
* [دليل إشارات المخاطر](https://docs.truthlocks.com/ar/guides/risk-signals.md)
* [مرجع API لاستيعاب إشارة المخاطر](https://docs.truthlocks.com/ar/api-reference/risk/ingest-signal.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.