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

# gliner-multi-pii-v1

> Model details for gliner-multi-pii-v1.

> GLiNER Multi PII is a multilingual PII detection and redaction model that supports on-prem deployments as well. It identifies 40+ personally identifiable entity types — identity, contact, government IDs, financial, medical and more. It works natively across six languages: English, French, German, Spanish, Italian, and Portuguese, so a single model covers multi-market and cross-border data without separate per-language pipelines. Built for zero-shot label, it accepts custom label sets at inference time and supports curated PII catalogues, redaction with label or character masks, and generic NER with user-supplied labels.

**References:** [Model docs](https://github.com/fastino-ai/GLiNER2/blob/main/README.md) • [Terms](https://github.com/fastino-ai/GLiNER2/blob/main/LICENSE) • [Privacy](https://github.com/fastino-ai/GLiNER2/blob/main/LICENSE)


## OpenAPI

````yaml api-reference/openapi/playgrounds/gliner-multi-pii-v1.openapi.json POST /responses
openapi: 3.1.0
info:
  title: gliner-multi-pii-v1 playground
  version: '1.0'
  description: >-
    Interactive playground for **gliner-multi-pii-v1**.

    Model is always `gliner-multi-pii-v1` on this page (shown in the form, not
    editable).

    Use the **request example** selector to switch use cases (JSON, NER, PII,
    etc.).

    Authentication: `x-api-key` (required) and `x-project-id` (optional).
servers:
  - url: https://api.zerogpu.ai/v1
    description: Production
security:
  - ApiKey: []
paths:
  /responses:
    post:
      tags:
        - gliner-multi-pii-v1
      summary: 'gliner-multi-pii-v1: Responses'
      operationId: createResponse_gliner-multi-pii-v1
      parameters:
        - name: x-project-id
          in: header
          required: false
          schema:
            type: string
          description: >-
            Optional project identifier. Scopes the request to a specific
            project when provided.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/CreateResponseRequest'
                - type: object
                  properties:
                    model:
                      type: string
                      const: gliner-multi-pii-v1
                      default: gliner-multi-pii-v1
                      example: gliner-multi-pii-v1
                      description: >-
                        Model identifier (fixed for this playground). Use
                        request examples to change use cases.
            examples:
              redact:
                summary: PII Redaction
                value:
                  input: >-
                    Hello Jane Doe, this is John Doe reaching out regarding my
                    recent order. If you need any additional details, feel free
                    to call me at 415-555-0134 during business hours. You can
                    also email me at hi@example.com, and I’ll respond as soon as
                    possible. Looking forward to your update on the issue.
                  model: gliner-multi-pii-v1
                  metadata:
                    mask: label
                    usecase: redact
              extract-pii:
                summary: PII Extraction
                value:
                  input: Contact John Doe at john@example.com or +1-415-555-0134.
                  model: gliner-multi-pii-v1
                  metadata:
                    usecase: extract-pii
                    threshold: 0.5
                    categories:
                      - identity
                      - contact
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
              examples:
                redact:
                  summary: PII Redaction
                  value:
                    redacted_text: >-
                      Hello [PERSON], this is [PERSON] reaching out regarding my
                      recent order. If you need any additional details, feel
                      free to call me at [PHONE_NUMBER] during business hours.
                      You can also email me at [EMAIL], and I will respond as
                      soon as possible.
                    entities:
                      - text: Jane Doe
                        label: person
                        start: 6
                        end: 14
                        score: 0.9982
                      - text: John Doe
                        label: person
                        start: 24
                        end: 32
                        score: 0.9981
                      - text: 415-555-0134
                        label: phone number
                        start: 133
                        end: 145
                        score: 0.9725
                      - text: hi@example.com
                        label: email
                        start: 194
                        end: 208
                        score: 0.9812
                    entities_by_label:
                      person:
                        - Jane Doe
                        - John Doe
                      phone number:
                        - 415-555-0134
                      email:
                        - hi@example.com
                extract-pii:
                  summary: PII Extraction
                  value:
                    entities:
                      - text: John Doe
                        label: person
                        start: 8
                        end: 16
                        score: 0.9989
                      - text: john@example.com
                        label: email
                        start: 20
                        end: 36
                        score: 0.9776
                      - text: +1-415-555-0134
                        label: phone number
                        start: 40
                        end: 55
                        score: 0.9714
                    entities_by_label:
                      person:
                        - John Doe
                      email:
                        - john@example.com
                      phone number:
                        - +1-415-555-0134
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '420':
          description: Insufficient quota
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
components:
  schemas:
    CreateResponseRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          const: gliner-multi-pii-v1
          default: gliner-multi-pii-v1
          example: gliner-multi-pii-v1
          description: >-
            Model identifier (fixed for this playground). Use request examples
            to change use cases.
        input:
          type: string
          minLength: 1
          format: textarea
          maxLength: 131072
          description: Multi-line text or document content to send to the model.
        metadata:
          type: object
          description: >-
            Use-case options for the model. Two use cases are supported:

            - `extract-pii` — return detected PII entities without altering the
            source text.

            - `redact` — mask detected PII in-line in the returned
            `redacted_text` (e.g. `[PERSON]`, `[EMAIL]`).
          additionalProperties: true
          properties:
            usecase:
              type: string
              enum:
                - extract-pii
                - redact
              default: extract-pii
              description: >-
                Which operation to run. `extract-pii` returns only the detected
                entities; `redact` also returns a masked `redacted_text`.
            mask:
              type: string
              enum:
                - label
              description: >-
                Redaction style, used when `usecase` is `redact`. `label`
                replaces each entity with a typed placeholder such as `[PERSON]`
                or `[EMAIL]`.
            threshold:
              type: number
              minimum: 0
              maximum: 1
              default: 0.5
              description: >-
                Minimum confidence score (0–1) an entity must reach to be
                returned. Lower values surface more, lower-confidence matches.
            categories:
              type: array
              items:
                type: string
              example:
                - identity
                - contact
              description: >-
                Restrict detection to specific PII category groups (e.g.
                `identity`, `contact`). Omit to detect all supported categories.
    Response:
      type: object
      additionalProperties: true
    ErrorResponse:
      type: object
      additionalProperties: true
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key

````