Processamento em Lote

Automatize a transcrição de múltiplos ficheiros em simultâneo. Aprenda estratégias, monitorização e boas práticas para maximizar a eficiência e os resultados.

Benefícios do Processamento em Lote

Como Funciona

Via Dashboard

Via API

# Envio de múltiplos ficheiros
curl -X POST https://api.vozparatexto.com.br/v1/batch/upload \
  -H "Authorization: Bearer SUA_API_KEY" \
  -F "files[]=@audio1.mp3" \
  -F "files[]=@audio2.mp3" \
  -F "files[]=@audio3.mp3" \
  -F "engine=ASSEMBLYAI" \
  -F "language=pt-PT"

// Resposta
{
  "batchId": "batch_abc123",
  "totalFiles": 3,
  "status": "PROCESSING",
  "files": [
    { "id": "upload_1", "name": "audio1.mp3", "status": "QUEUED" },
    { "id": "upload_2", "name": "audio2.mp3", "status": "QUEUED" },
    { "id": "upload_3", "name": "audio3.mp3", "status": "QUEUED" }
  ]
}

Limites e Configurações

| Recurso | Plano Gratuito | Plano Lite | Plano Advanced | Plano Pro | |---|---|---|---|---| | Ficheiros por lote | 3 | 10 | 25 | 100 | | Processamento paralelo | 1 | 2 | 3 | 5 | | Tamanho máximo do lote | 100 MB | 500 MB | 2 GB | 10 GB | | Prioridade na fila | Normal | Normal | Alta | Máxima |

Monitorização de Lotes

Estado dos Ficheiros

| Estado | Descrição | |---|---| | QUEUED | Na fila, a aguardar processamento | | UPLOADING | Envio em curso | | PROCESSING | Transcrição em curso | | COMPLETED | Transcrição concluída com sucesso | | FAILED | Falha no processamento | | RETRYING | A tentar novamente automaticamente |

Dashboard de Monitorização

O painel de lotes apresenta:

• Progresso geral do lote (percentagem)
• Estado individual de cada ficheiro
• Tempo estimado de conclusão
• Créditos consumidos vs. estimados
• Registos de erros por ficheiro

Estratégias de Otimização

Organização de Ficheiros

• Agrupe ficheiros por projeto ou tema
• Utilize nomenclatura consistente
• Separe por idioma quando necessário
• Ordene por prioridade

Definições Recomendadas

• Utilize o AssemblyAI (predefinido, 4 ciclos/min) pela qualidade, com identificação de oradores e pontuação; para grande volume gastando menos, use o Whisper (Normal, 1 ciclo/min)
• Ative a identificação de oradores apenas quando necessário
• Escolha o idioma correto para melhor precisão
• Configure webhooks para notificação de conclusão

Resolução de Problemas

Alguns ficheiros falharam no lote

Possíveis causas: Formato não suportado, ficheiro corrompido, créditos insuficientes.

Soluções: Verifique os formatos dos ficheiros com erro, tente reprocessar individualmente, confirme o saldo de créditos.

Processamento muito lento

Possíveis causas: Muitos ficheiros grandes, horário de pico, limite de processamento paralelo.

Soluções: Divida em lotes menores, envie em horários alternativos, considere upgrade de plano para mais slots paralelos.

Resultados inconsistentes entre ficheiros

Possíveis causas: Qualidade de áudio variável, idiomas diferentes, definições incorretas.

Soluções: Normalize o áudio antes do envio, configure o idioma por ficheiro quando necessário, reveja as definições do lote.

Continue a aprender

• Integração via API - Automatize envios em lote via API
• Webhooks e Notificações - Receba alertas de conclusão
• Automação de Fluxos - Crie fluxos automáticos para lotes