Skip to main content

Riferimento API

L’API VoiceCheap è organizzata secondo i principi REST. Utilizza metodi HTTP standard, restituisce risposte codificate in JSON e utilizza codici di risposta HTTP standard.

URL di base

Tutte le richieste API devono essere effettuate a:

Autenticazione

Tutte le richieste richiedono una chiave API passata nell’intestazione x-api-key. Vedi la pagina Autenticazione per i dettagli.

Tipi di contenuto

  • Richiesta: Usa multipart/form-data per i caricamenti di file, application/json per altre richieste
  • Risposta: Gli endpoint JSON restituiscono application/json. Le esportazioni di trascrizioni possono anche restituire testo SRT o VTT.

Endpoint disponibili

Trascrivi media

POST /v1/transcribeTrascrivi un file caricato come JSON, SRT o VTT.

Esporta trascrizione progetto

POST /v1/projects/{projectId}/transcriptRecupera le trascrizioni originali o tradotte del progetto.

Avvia traduzione

POST /v1/translateCarica un file video o audio e avvia un progetto di traduzione.

Ottieni stato traduzione

GET /v1/translate/{projectId}/statusControlla lo stato di un progetto di traduzione e recupera i risultati.

Ottieni dettagli progetto

GET /v1/projects/{projectId}Recupera la cronologia delle versioni tradotte, la cronologia della sincronizzazione labiale e lo stato del progetto.

Elimina progetto

DELETE /v1/translate/{projectId}Elimina definitivamente un progetto di traduzione e le sue risorse.

Flusso di lavoro di traduzione

Il flusso di lavoro tipico per tradurre un video è:

Formato di risposta

Tutte le risposte riuscite seguono questa struttura generale:
Le risposte di errore seguono questa struttura:

Codici di stato HTTP