▶Contenuti API

Documentazione Votxt OpenAPI

Beta Votxt OpenAPI e in beta. Prova le integrazioni in sviluppo prima dell'uso in produzione.

Panoramica

Votxt OpenAPI integra trascrizione audio e video in applicazioni e automazioni.

Carica un file o usa un URL esterno, poi crea un'attivita di trascrizione e controlla lo stato.

Al termine, esporta trascritti, sottotitoli e dati strutturati in piu formati.

URL base

https://api.votxt.co

Autenticazione

Invia la chiave API nell'header della richiesta. L'accesso API richiede un piano attivo compatibile.

X-API-Key: your_api_key_here

Apri le impostazioni dell'account.
Verifica che il piano includa accesso API.
Crea una chiave API e conservala in modo sicuro.

Caricamento file

Usa caricamento diretto con URL firmati o fornisci un URL pubblico di file esterno.

POST /api/v1/files/upload-url
PUT upload_url
POST /api/v1/transcriptions

POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key

{
  "filename": "audio.mp3",
  "file_size": 1048576,
  "upload_expires_in": 3600,
  "download_expires_in": 1800
}

Trascrizione

Endpoint	Metodo	Descrizione
/api/v1/transcriptions	POST	Caricamento file
/api/v1/transcriptions/youtube	POST	YouTube
/api/v1/transcriptions	GET	Trascrizioni
/api/v1/transcriptions/{id}	GET	Trascrizione
/api/v1/transcriptions/{id}/status	GET	Stato

POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key

{
  "file_key": "12345-abc123def456.mp3",
  "filename": "audio.mp3",
  "language_code": "en",
  "transcription_type": "transcript",
  "enable_speaker_diarization": false,
  "webhook_url": "https://your-app.com/webhook"
}

Stato

Stato	Trascrizione
queued	In coda
preprocessing	Pre-elaborazione
processing	Elaborazione
completed	Completato
failed	Non riuscito

Esportazioni