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

# Verify a speaker

> Compares a recording with a voiceprint. A helper signal, not a login: it is not protected against recorded or synthetic voices.



## OpenAPI

````yaml /stt/openapi.json post /v1/voiceprints/verify
openapi: 3.0.3
info:
  title: Umay STT API
  version: 1.0.25
  description: >-
    Speech recognition: files, voiceprints and audio isolation. Live audio uses
    the WebSocket endpoints in the guide pages.
servers:
  - url: https://stt.eu.mihu.ai
    description: Europe (EU)
  - url: https://stt.tr.mihu.ai
    description: Türkiye (TR)
security:
  - bearerAuth: []
tags:
  - name: Service
  - name: Transcription
  - name: Voiceprints
  - name: Audio isolation
paths:
  /v1/voiceprints/verify:
    post:
      tags:
        - Voiceprints
      summary: Verify a speaker
      description: >-
        Compares a recording with a voiceprint. A helper signal, not a login: it
        is not protected against recorded or synthetic voices.
      operationId: verifySpeaker
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                voiceprint:
                  type: string
                  description: Stored voiceprint `id` or a `store=false` `token`.
                file:
                  type: string
                  description: The audio. Any common format (WAV, MP3, ...).
                  format: binary
                file_url:
                  type: string
                  description: >-
                    Instead of `file`: `https://` URL the server downloads the
                    audio from (up to 1 GB, 10 minutes, public addresses only).
                nonce:
                  type: string
                  description: >-
                    Optional, up to 200 characters: returned and signed, so your
                    backend can refuse a replayed result.
              required:
                - voiceprint
      responses:
        '200':
          description: The result
          content:
            application/json:
              example:
                id: e4c1a7d2
                object: voiceprint.verification
                voiceprint: 9b2f6c1e-3d4a-4f8b-a1c2-7e5d9f0b3a61
                score: 0.81
                match: true
                decision: match
                threshold: 0.55
                speech_seconds: 6.2
                created_at: 1793171000
                nonce: session-77
                account: 7d1e
                signed: eyJhbGciOiJFZERTQSIs...
        '400':
          description: Invalid field
        '401':
          description: Missing or wrong API key
        '404':
          description: Not found, or it belongs to another API key
        '409':
          description: Conflict
        '422':
          description: Invalid value or unusable audio
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key

````

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