Elaborazione in Batch

Automatizza la trascrizione di più file contemporaneamente. Scopri strategie, monitoraggio e buone pratiche per massimizzare efficienza e risultati.

Vantaggi dell'Elaborazione in Batch

Come Funziona

Tramite Dashboard

Tramite API

# Carica più file
curl -X POST https://api.vozparatexto.com.br/v1/batch/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files[]=@audio1.mp3" \
  -F "files[]=@audio2.mp3" \
  -F "files[]=@audio3.mp3" \
  -F "engine=ASSEMBLYAI" \
  -F "language=en-US"

// Risposta
{
  "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" }
  ]
}

Limiti e Impostazioni

| Risorsa | Piano Gratuito | Piano Lite | Piano Advanced | Piano Pro | |---|---|---|---|---| | File per batch | 3 | 10 | 25 | 100 | | Elaborazione parallela | 1 | 2 | 3 | 5 | | Dimensione massima batch | 100 MB | 500 MB | 2 GB | 10 GB | | Priorità coda | Normale | Normale | Alta | Massima |

Monitoraggio Batch

Stati dei File

| Stato | Descrizione | |---|---| | QUEUED | In coda in attesa di elaborazione | | UPLOADING | Caricamento in corso | | PROCESSING | Trascrizione in corso | | COMPLETED | Trascrizione completata con successo | | FAILED | Elaborazione fallita | | RETRYING | Riprova automatica in corso |

Dashboard di Monitoraggio

Il pannello batch mostra:

• Progresso complessivo del batch (percentuale)
• Stato di ogni singolo file
• Tempo stimato di completamento
• Crediti consumati rispetto a quelli stimati
• Log degli errori per file

Strategie di Ottimizzazione

Organizzazione dei File

• Raggruppa i file per progetto o argomento
• Usa convenzioni di denominazione coerenti
• Separa per lingua quando necessario
• Ordina per priorità

Impostazioni Consigliate

• Usa AssemblyAI per il miglior rapporto qualità-prezzo (15 cicli/min)
• Abilita l'identificazione del parlante solo quando necessario
• Scegli la lingua corretta per la migliore precisione
• Imposta webhook per le notifiche di completamento

Risoluzione dei Problemi

Alcuni file nel batch sono falliti

Possibili cause: Formato non supportato, file danneggiato, crediti insufficienti.

Soluzioni: Controlla i formati dei file falliti, prova a rielaborarli singolarmente, verifica il tuo saldo crediti.

L'elaborazione è molto lenta

Possibili cause: Molti file grandi, ore di punta, limite di elaborazione parallela.

Soluzioni: Dividi in batch più piccoli, invia durante le ore non di punta, considera di aggiornare il piano per più slot paralleli.

Risultati inconsistenti tra i file

Possibili cause: Qualità audio variabile, lingue diverse, impostazioni errate.

Soluzioni: Normalizza l'audio prima del caricamento, configura la lingua per file quando necessario, rivedi le impostazioni del batch.

Continua ad imparare

• Integrazione API - Automatizza i caricamenti batch tramite API
• Webhook e Notifiche - Ricevi avvisi di completamento
• Automazione dei Flussi di Lavoro - Crea flussi automatizzati per i batch