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

# Metin Moderasyonu

> Sadece metin içeriğini analiz ederek zararlı ifadeleri tespit eder

## Metin Moderasyonu API'si

Bu endpoint, sadece metin içeriğinin moderasyon analizini yapar. `/moderation` endpoint'inin daha basitleştirilmiş halidir ve doğrudan metin girdisi alır.

### Kullanım Senaryoları

* Sohbet mesajlarının zararlı içerik kontrolü
* Forum yorumlarının filtrelenmesi
* Otomatik metin içerik denetimi
* Sosyal medya içeriklerinin analizi

### Analiz Sonuçları

Endpoint, metindeki içeriği aşağıdaki kategorilerde skorlar:

| Kategori    | Açıklama                                      |
| ----------- | --------------------------------------------- |
| NEUTRAL     | İçeriğin zararlı olmadığı anlamına gelir      |
| SEXUAL      | Cinsel içerik tespiti                         |
| HATE        | Nefret söylemi tespiti                        |
| SELF\_HARM  | Kendine zarar vermeyle ilgili içerik tespiti  |
| BAD\_HABITS | Zararlı alışkanlıklarla ilgili içerik tespiti |

### Örnek Kullanım

Bu endpoint, standart `/moderation` endpoint'inden farklı olarak sadece `input` parametresi gerektirir ve `type` parametresi gerekmez:

```json theme={null}
{
  "input": "Analiz edilecek metin içeriği"
}
```

### Yanıt Değerlendirme

Analiz sonucunda dönen skorlar 0 ile 1 arasındadır ve şu şekilde değerlendirilebilir:

* **0.0 - 0.3**: Düşük risk - İçerik büyük olasılıkla güvenlidir
* **0.3 - 0.7**: Orta risk - İncelemeye değer olabilir
* **0.7 - 1.0**: Yüksek risk - İçerik muhtemelen güvenli değildir

Her kategori için `flags` kısmında da boolean değerler döner. Bu değerler, belirli eşik değerlerini geçen kategoriler için `true` olarak belirlenir.


## OpenAPI

````yaml POST /moderation/text
openapi: 3.1.0
info:
  title: Detectivision API
  description: Detectivision içerik moderasyonu API'si
  version: 1.0.0
servers:
  - url: https://dev-api.detectivision.ai/api/v1
security:
  - apiKeyAuth: []
paths:
  /moderation/text:
    post:
      tags:
        - Moderation
      summary: Metin Moderasyonu
      description: Sadece metin içeriğini analiz ederek zararlı ifadeleri tespit eder
      operationId: moderateText
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModerationTextRequest'
      responses:
        '200':
          description: Başarılı analiz sonucu
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModerationResponse'
        '400':
          description: Hatalı istek
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Yetkilendirme hatası
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ModerationTextRequest:
      type: object
      required:
        - input
      properties:
        input:
          type: string
          description: Analiz edilecek metin içeriği
          example: selam
    ModerationResponse:
      type: object
      properties:
        id:
          type: integer
          description: Moderasyon işleminin ID'si
          example: 25
        jobId:
          type: integer
          description: İşlem ID'si
          example: 122
        result:
          type: object
          properties:
            language:
              type: string
              description: Tespit edilen dil
              example: tr
            scores:
              type: object
              properties:
                NEUTRAL:
                  type: number
                  description: Nötr içerik skoru
                  format: float
                  example: 0.9886459112167358
                SEXUAL:
                  type: number
                  description: Cinsel içerik skoru
                  format: float
                  example: 0.0022032149136066437
                HATE:
                  type: number
                  description: Nefret söylemi skoru
                  format: float
                  example: 0.001250135712325573
                SELF_HARM:
                  type: number
                  description: Kendine zarar verme içeriği skoru
                  format: float
                  example: 0.001079669571481645
                BAD_HABITS:
                  type: number
                  description: Kötü alışkanlıklar içeriği skoru
                  format: float
                  example: 0.00073793507181108
            flags:
              type: object
              properties:
                NEUTRAL:
                  type: boolean
                  description: İçeriğin nötr olup olmadığını belirtir
                  example: true
                SEXUAL:
                  type: boolean
                  description: İçeriğin cinsel içerikli olup olmadığını belirtir
                  example: false
                HATE:
                  type: boolean
                  description: İçeriğin nefret söylemi içerip içermediğini belirtir
                  example: false
                SELF_HARM:
                  type: boolean
                  description: İçerikte kendine zarar verme teması olup olmadığını belirtir
                  example: false
                BAD_HABITS:
                  type: boolean
                  description: >-
                    İçerikte kötü alışkanlıklardan bahsedilip bahsedilmediğini
                    belirtir
                  example: false
        createdAt:
          type: integer
          description: İşlemin oluşturulduğu zaman (Unix timestamp)
          example: 1742201764
        updatedAt:
          type: integer
          description: İşlemin son güncellendiği zaman (Unix timestamp)
          example: 1742201764
    Error:
      type: object
      properties:
        error:
          type: string
          description: Hata kodu
          example: invalid_request
        message:
          type: string
          description: Hata mesajı
          example: Geçersiz istek parametreleri
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: API-Key

````