> ## 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.

# Create a voiceprint

> Stores one person's voiceprint, with their consent. 3-120 s of one person speaking; 15-20 s of speech recommended. The recording is not kept.



## OpenAPI

````yaml /stt/openapi.json post /v1/voiceprints
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:
    post:
      tags:
        - Voiceprints
      summary: Create a voiceprint
      description: >-
        Stores one person's voiceprint, with their consent. 3-120 s of one
        person speaking; 15-20 s of speech recommended. The recording is not
        kept.
      operationId: createVoiceprint
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                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).
                name:
                  type: string
                  description: Your label, 1-100 characters.
                  example: Customer 1042
                consent:
                  type: boolean
                  description: >-
                    Must be `true`: you confirm the person agreed to their
                    voiceprint being stored and used.
                consent_reference:
                  type: string
                  description: >-
                    Optional, up to 200 characters: your reference to the
                    consent record.
                store:
                  type: boolean
                  description: >-
                    `true`: we keep the voiceprint and answer its `id`. `false`:
                    we keep nothing and answer a `token`.
                  default: true
              required:
                - name
                - consent
      responses:
        '200':
          description: The voiceprint
          content:
            application/json:
              example:
                id: 9b2f6c1e-3d4a-4f8b-a1c2-7e5d9f0b3a61
                object: voiceprint
                name: Customer 1042
                speech_seconds: 14.2
                created_at: 1793170800
                consent:
                  given: true
                  at: 1793170800
                  reference: CRM-CONSENT-88123
        '400':
          description: Invalid field
        '401':
          description: Missing or wrong 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.