---
title: "Tentar a transcrição de um áudio de novo"
method: POST
path: "/api/management/medias/{media}/transcription/retry"
tags: ["projects", "Conteúdos e arquivos"]
---

# Tentar a transcrição de um áudio de novo

`POST /api/management/medias/{media}/transcription/retry`

## Request

- Base URL: `https://api.olie.ai`
- URL: `https://api.olie.ai/api/management/medias/{media}/transcription/retry`
- Auth: HTTP bearer

Envia de novo para transcrição um áudio cuja transcrição falhou, ficou sem créditos de IA (`insufficient_credits`), ou permanece em `processing` há mais de 60 segundos. A resposta segue o formato da listagem de conteúdos: traz `transcription_status` `processing` e `transcription` nulo, e não traz `transcription_started_at`.

A configuração da empresa `audio_transcription_enabled` precisa estar ligada. Sem ela, a resposta é 403 com `message` `audio_transcription_disabled`.

Só entra áudio (`type` 3) com `transcription_status` `failed` ou `insufficient_credits`, ou `processing` cuja tentativa começou há mais de 60 segundos. `completed`, `no_speech`, `too_long`, status nulo e qualquer conteúdo que não seja áudio respondem 422, com `validation.transcription_status` igual a `This audio cannot be retried.` Uma segunda chamada enquanto a nova tentativa ainda não completou 60 segundos também responde 422.

O usuário precisa da permissão de conteúdo do projeto (`projects.media.{id}`). Um token de aplicação recebe 403 com `message` `access_denied_for_applications`. Áudio de outra conta responde 404 com `message` `media_model_not_found`.

## Path parameters

- `media` string, uuid, required

## Response `200`

Áudio recolocado na fila de transcrição

- object: Conteúdo do projeto, no formato do recurso de mídia.
  - `response` boolean, required: Sempre true quando a operação é concluída.
  - `media` object, required: Áudio com a nova tentativa processando.
    - `id` string, uuid: ID (UUID) do conteúdo.
    - `name` string: Nome do conteúdo ou do arquivo.
    - `technical_name` string: Nome interno usado no armazenamento.
    - `type` integer: Tipo do conteúdo: 1 texto, 2 arquivo, 3 áudio.
    - `extension` string: Extensão do arquivo, quando houver.
    - `text` string: Texto enviado, quando houver.
    - `file_url` string: Endereço para baixar o arquivo, quando houver.
    - `transcription_status` 'processing' | 'completed' | 'no_speech' | 'failed' | 'too_long' | 'insufficient_credits': Situação da transcrição do áudio. Nulo quando ninguém tentou transcrever: texto, arquivo, áudio que já estava no projeto ou conta com a transcrição desligada na configuração da empresa. `processing` ainda está processando. `completed` gravou o texto em `transcription`. `no_speech`, `failed`, `too_long` e `insufficient_credits` terminam sem texto gravado.
    - `transcription` string: Texto do que foi falado no áudio. Preenchido só quando `transcription_status` é `completed`. Nos outros resultados fica nulo: as frases de áudio sem fala, falha, acima do limite ou sem créditos não são gravadas aqui.
    - `log` string: Conteúdo do registro de atividade, quando a entrada for um log.
    - `user_id` string, uuid: Usuário que enviou o conteúdo.
    - `frame_id` string, uuid: ID (UUID) da conta dona do conteúdo.
    - `project_id` string, uuid: Projeto que recebeu o conteúdo.
    - `channel_id` string, uuid: ID (UUID) do canal, quando o conteúdo veio de uma conversa.
    - `direction` string: Direção do conteúdo no canal (entrada ou saída), quando aplicável.
    - `origin` string: Origem do conteúdo (ex.: integração ou compositor interno).
    - `external_message_id` string: ID da mensagem na integração externa, quando houver.
    - `task_id` string, uuid: ID (UUID) da tarefa vinculada, quando o conteúdo pertence a uma tarefa.
    - `delivery_error` string: Erro de entrega na integração, quando o envio falhou.
    - `created_at` string, date-time: Data do envio.
    - `updated_at` string, date-time: Data da última alteração.
    - `deleted_at` string, date-time: Data em que o conteúdo foi removido.
    - `user` object: Quem enviou o conteúdo.
    - `project` object: Projeto relacionado, quando carregado.

## Other responses

- `403`: Transcrição desligada na empresa, sem permissão de conteúdo ou token de aplicação
- `404`: Áudio não encontrado nesta conta
- `422`: Este áudio não pode ser transcrito de novo

## Changes

- **2026-10-19** `157bad49221f`: 3 warning, 1 info
  - removed the optional property `feature` from the response with the `403` status
  - added the new `audio_transcription_disabled` enum value to the `message` response property for the response status `403`
  - added the new `insufficient_credits` enum value to the `media/transcription_status` response property for the response status `200`
  - removed the `feature_disabled` enum value from the `message` response property for the response status `403`
- **2026-10-05** `8d95137e7df4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/medias/:media/transcription/retry/post.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/fbae0c094507?raw)