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

# Isolate a recording

> Send a recording, get the same recording back with other people talking in the background and noise removed. No text is returned: this endpoint gives audio, not a transcript. Up to 120 s synchronously; longer audio needs `webhook_url`. One person is kept: for a conversation in one channel send `remove_voices=false`, which removes noise only.



## OpenAPI

````yaml /stt/openapi.json post /v1/audio/isolation
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/audio/isolation:
    post:
      tags:
        - Audio isolation
      summary: Isolate a recording
      description: >-
        Send a recording, get the same recording back with other people talking
        in the background and noise removed. No text is returned: this endpoint
        gives audio, not a transcript. Up to 120 s synchronously; longer audio
        needs `webhook_url`. One person is kept: for a conversation in one
        channel send `remove_voices=false`, which removes noise only.
      operationId: createIsolation
      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).
                language:
                  type: string
                  description: Language of the speech.
                  enum:
                    - tr
                    - en
                    - de
                    - fr
                    - it
                    - ru
                    - es
                  example: tr
                reference_voiceprint:
                  type: string
                  description: >-
                    Id or `vpt1.` token of a voiceprint: keep this person,
                    remove everyone else.
                remove_voices:
                  type: boolean
                  description: '`false`: never remove voices, only noise.'
                  default: true
                response_format:
                  type: string
                  description: Format of the answer.
                  enum:
                    - wav
                    - flac
                    - mp3
                  default: wav
                sample_rate:
                  type: integer
                  description: Hz of the answer.
                  enum:
                    - 48000
                    - 16000
                  default: 48000
                webhook_url:
                  type: string
                  description: >-
                    `https://` URL that receives the result (`POST`, JSON). With
                    it the request answers `202` at once. Must resolve to a
                    public address.
                webhook_secret:
                  type: string
                  description: >-
                    Optional, 1-256 characters: the webhook is signed with it
                    (`X-Mihu-Signature`).
                webhook_metadata:
                  type: string
                  description: 'Optional, up to 4 KB: echoed back as `metadata`.'
      responses:
        '200':
          description: >-
            The isolated audio. Headers: `X-Isolation`, `X-Audio-Seconds`,
            `X-Processing-Time`, `X-Sample-Rate`.
          content:
            audio/wav:
              schema:
                type: string
                format: binary
        '202':
          description: Accepted (with `webhook_url`)
          content:
            application/json:
              example:
                id: 0b6f2a9e-5c1d-4e8b-9f3a-7d2c1e0a4b58
                object: audio.isolation.job
                status: queued
                duration: 3600
                created_at: 1793145600
                source:
                  type: upload
                  filename: call-60min.mp3
                  size_bytes: 57600417
                request:
                  language: tr
                  response_format: flac
                  sample_rate: 48000
                  remove_voices: true
        '400':
          description: Invalid field
        '401':
          description: Missing or wrong API key
        '413':
          description: File larger than 1 GB or audio longer than 4 hours
        '429':
          description: More than 20 jobs of this API key waiting or running
        '503':
          description: Server busy; retry later
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.