API Trascrizione

Invia contenuti multimediali per la trascrizione AI e la creazione del progetto. Supporta sia file Video che Audio.

POST/api/v1/transcribe

Implementazione Rapida

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

Parametri della Richiesta

Parametro	Tipo	Richiesto	Descrizione
`file`	File	Yes	Il file multimediale da trascrivere (Multipart). Supportati: Video (mp4, mov, avi, webm, mkv), Audio (mp3, wav, m4a, flac). Max 2GB.
`videoUrl`	String	No*	URL esterno del media (richiesto se il file non è fornito nel corpo).
`name`	String	No	Nome personalizzato per il progetto.
`languageCode`	String	No	Codice della lingua sorgente (es. 'it-it'). Il valore predefinito è 'auto' (rilevamento automatico) se omesso.
`filterProfanity`	Boolean	No	Se censurare automaticamente le parole esplicite. Il valore predefinito è false.
`disfluencies`	Boolean	No	Se includere parole di riempimento (es. 'ehm', 'uh'). Il valore predefinito è false.
`medicalMode`	Boolean	No	Trascrizione ottimizzata per audio sanitario/medico. Il valore predefinito è false.

Avanzato: URL + Impostazioni AI

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

Risposta di Successo

Una richiesta riuscita restituisce uno stato 200 OK con il progetto e i dettagli del lavoro in background.

projectIdL'identificatore univoco per il tuo progetto.
status'inProgress' (trascrizione in corso).
Nota: I crediti vengono calcolati e detratti dal tuo saldo in modo asincrono al termine del processo di trascrizione.

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

Codici di Errore

Stato	Codice Errore	Descrizione
400	missing_file	Nessun file trovato nel campo 'file' o 'video'.
400	unreachable_url	L'URL video fornito non è raggiungibile o ha restituito un errore.
400	invalid_parameter	Uno dei parametri (es. videoUrl) è malformato.
400	file_read_failed	Il file caricato non può essere letto o è danneggiato.
401	unauthorized	Chiave API mancante o non valida.
403	insufficient_balance	Non hai abbastanza crediti per elaborare la durata di questo media.
403	storage_quota_exceeded	Il file supera la quota di archiviazione cloud rimanente del tuo piano.
413	payload_too_large	Il file supera il limite assoluto di caricamento del sistema di 2GB.
500	transcription_failed	Non è stato possibile avviare il lavoro di trascrizione (interruzione del fornitore AI).
500	server_error	Qualcosa è andato storto, per favore riprova più tardi.

Struttura della Risposta di Errore

{
  "success": false,
  "error": "insufficient_balance",
  "message": "Il tuo progetto richiede 5 crediti, ma il tuo saldo è 2."
}

Questa pagina è stata utile?