4 min de leitura Envio de Arquivos

Enviar Áudio por URL e pela API

Como importar áudio por URL direta na interface e como enviar transcrições programaticamente pela API: planos elegíveis, chaves, autenticação, limites e webhooks.

Além do upload de arquivo, há dois caminhos "sem arquivo na mão": colar uma URL de mídia na interface (para qualquer usuário) e enviar pela API (para planos Profissional e acima) — ideal para integrar a transcrição a sistemas, PABX e automações.

1. Importar por URL na interface

Na tela de Nova transcrição, a mesma opção que aceita YouTube aceita URLs diretas de arquivos de áudio/vídeo (https). O servidor baixa a mídia e segue o fluxo normal: escolha de idioma (ou detecção automática), motor do plano e custo em ciclos pela duração. Os limites de duração e tamanho do seu plano valem igual.

2. API de transcrição

Quem pode usar

A API é liberada a partir do plano Profissional (R$ 39,90/mês) — incluindo Premium, planos empresariais e legados equivalentes. Em outros planos, a criação de chave retorna que o plano não é elegível.

Chaves de API

Formato do token: vpt_live_...;
O segredo é exibido uma única vez, na criação — guarde-o num cofre. Não guardamos o segredo, apenas uma impressão digital dele;
Até 20 chaves ativas por conta; revogue qualquer uma a qualquer momento;
A área de gerenciamento de chaves pessoais na interface está em implantação — se não encontrar a opção na sua conta, abra um ticket que ativamos para você.

Como funciona uma chamada

Autenticação por header Authorization: Bearer vpt_live_.... No corpo, você informa a URL do áudio (audio_url, somente https), a URL do seu webhook para receber o resultado, e opcionalmente motor, idioma, formatos de exportação e chave de idempotência.

Rate limit: 60 requisições por minuto por chave;
Tamanho: áudio por URL de até 500 MB para download no servidor; com o motor Premium, URLs de até 5 GB podem ser lidas diretamente pelo motor, sem download intermediário;
Custo: os mesmos ciclos do site, pela duração e motor.

Recebendo o resultado (webhooks)

O resultado chega por webhook assinado com HMAC-SHA256 (headers X-VPT-Signature e X-VPT-Event) — valide a assinatura antes de confiar no payload. Se o seu endpoint estiver fora do ar, reenviamos com recuo progressivo: até 6 tentativas ao longo de ~24 horas.

Só aceitamos URLs https e bloqueamos endereços internos/privados por segurança. Se o seu áudio está atrás de autenticação, gere uma URL temporária assinada no seu storage antes de chamar a API.

Sem URL pública para o arquivo (ex.: gravações de PABX)? A API empresarial de auditoria oferece um endpoint de upload que devolve uma URL de envio temporária (válida por 1 hora) — fale com vendas se o seu caso é de auditoria de chamadas em volume.

Perguntas frequentes

Perdi o segredo da chave. Como recupero?

Não dá para recuperar — revogue a chave e crie outra. O segredo só existe no momento da criação.

A API tem documentação?

A referência completa de integração é fornecida junto com a ativação do acesso. Abra um ticket informando seu caso de uso.

Posso escolher motor e idioma na chamada?

Sim, ambos são parâmetros opcionais — sem eles, valem o motor padrão do plano e a detecção de idioma.

A API cobra diferente do site?

Não. Mesmos ciclos, mesmas regras (inclusive o desconto só após sucesso).

Como revogo uma chave comprometida?

Revogue-a imediatamente na gestão de chaves (ou via suporte). A revogação corta o acesso na hora.