Documentação prática

Preencha token + áudio abaixo. A documentação gera cURL e o passo a passo do Postman prontos para copiar. Base: https://audio-api.autoenvia.com.br

1. Sua configuração (salva só neste navegador)

Privacidade O Bearer fica no IndexedDB deste navegador (sobrevive a refresh). Não vai para o servidor da documentação nem fica visível para outras pessoas.
Crie em Admin → Tokens. não salvo
O navegador não lê o path real por segurança — informe a pasta e selecione o arquivo.
Nenhum arquivo selecionado

2. Opções (iguais à Demonstração)

Defaults recomendados: qualidade boa + resposta rápida (language=pt, enhance e trim ligados, prompt vazio).

3. Exemplos gerados

Windows: use 1 linha Se você quebrar linha com ` e deixar espaço depois, o curl trata cada pedaço como URL e mostra curl: (3) URL rejected: Bad hostname — mesmo depois de um 200 OK.
PowerShell / CMD (1 linha)
Bash / Linux / macOS
Só health (sem token)
curl.exe https://audio-api.autoenvia.com.br/api/health
Seu 404 veio da URL A resposta foi Cannot POST /api/transcribe%0A. %0A = Enter colado no final da URL. Apague o ↵ na barra do Postman.
Chave do arquivo = audio Em form-data, a coluna KEY deve ser exatamente audio. O dropdown File / Text ao lado não é o nome da chave — não use Type como KEY (isso quebra o upload).

Copie cada campo (botão Copiar) e cole no Postman — um por vez:

1) Method
POST
2) URL (cole e confira: sem ↵ no final)
https://audio-api.autoenvia.com.br/api/transcribe
3) Authorization → Bearer Token

4) Body → form-data (montagem correta)

KEY (nome)DropdownVALUE
audio File Selecione o .ogg (sumir o ⚠ amarelo)
language Text pt
enhance Text true
trim Text true
KEY do arquivo (copiar)
audio
    Checklist URL sem ↵ · KEY do arquivo = audio (não Type) · arquivo sem ⚠ · Auth Bearer · timeout 180000
    Resumo (não cole na URL)
    Base URL
    https://audio-api.autoenvia.com.br
    Health
    https://audio-api.autoenvia.com.br/api/health
    Transcribe
    https://audio-api.autoenvia.com.br/api/transcribe

    Endpoints

    MétodoURLAuth
    GET https://audio-api.autoenvia.com.br/api/health Não
    POST https://audio-api.autoenvia.com.br/api/transcribe Bearer

    Campo obrigatório: audio (multipart). Opcionais: language, prompt, enhance, trim. Formatos: .ogg .opus .mp3 .wav .m4a · máx. 25 MB.

    Erros HTTP

    CódigoSignificado
    400Arquivo ausente / extensão inválida / opções inválidas
    401Token ausente ou inválido
    403Token inativo ou IP bloqueado
    413Arquivo grande demais
    429Rate limit
    500Falha FFmpeg / Whisper

    Por que apareceu “Bad hostname”?

    No Postman, a resposta Cannot POST /api/transcribe%0A significa que a URL tinha um Enter no final (%0A). Apague o ↵ na barra de URL ou use o botão Copiar da URL na aba Postman (já vem sem quebra de linha).

    No curl do Windows, use o exemplo de 1 linha — backtick com espaço gera Bad hostname mesmo depois de um 200 OK.