4 min de leitura Envio de Ficheiros

Enviar Áudio por URL e pela API

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

Além do carregamento de ficheiros, há dois caminhos "sem ficheiro na mão": colar uma URL de multimédia no ecrã (para qualquer utilizador) e enviar pela API (para planos Profissional e acima) — ideal para integrar a transcrição em sistemas, PABX e automações.

1. Importar por URL no ecrã

No ecrã de Nova transcrição, a mesma opção que aceita YouTube aceita URLs diretas de ficheiros de áudio/vídeo (https). O servidor descarrega a multimédia e segue o fluxo normal: escolha do idioma (ou deteção automática), motor do plano e custo em ciclos pela duração. Os limites de duração e tamanho do teu plano aplicam-se igualmente.

2. API de transcrição

Quem pode utilizar

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

Chaves de API

Formato do token: vpt_live_...;
O segredo é exibido uma única vez, na criação — guarda-o num cofre. Não guardamos o segredo, apenas uma impressão digital dele;
Até 20 chaves ativas por conta; podes revogar qualquer uma a qualquer momento;
A área de gestão de chaves pessoais no ecrã está em implementação — se não encontrares a opção na tua conta, abre um ticket e nós ativamos o acesso para ti.

Como funciona uma chamada

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

Rate limit: 60 pedidos por minuto por chave;
Tamanho: áudio por URL até 500 MB para descarregar no servidor; com o motor Premium, URLs até 5 GB podem ser lidas diretamente pelo motor, sem descarregamento intermédio;
Custo: os mesmos ciclos do site, consoante a duração e o motor.

Receber o resultado (webhooks)

O resultado chega por webhook assinado com HMAC-SHA256 (headers X-VPT-Signature e X-VPT-Event) — valida a assinatura antes de confiares no payload. Se o teu endpoint estiver indisponível, 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 teu áudio estiver protegido por autenticação, gera uma URL temporária assinada no teu armazenamento antes de chamares a API.

Não tens URL pública para o ficheiro (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) — fala com vendas se o teu caso é de auditoria de chamadas em volume.

Perguntas frequentes

Perdi o segredo da chave. Como recupero?

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

A API tem documentação?

A referência completa de integração é fornecida juntamente com a ativação do acesso. Abre um ticket indicando o teu 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 deteção de idioma.

A API cobra diferente do site?

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

Como revogo uma chave comprometida?

Revoga-a imediatamente na gestão de chaves (ou através do suporte). A revogação corta o acesso na hora.