Skip to main content

​
Riferimento API

L’API VoiceCheap usa metodi e codici di stato HTTP standard. La maggior parte degli endpoint restituisce JSON; le esportazioni delle trascrizioni possono restituire anche SRT o VTT. Per le impostazioni dell’account, la gestione del team, gli strumenti multimediali e altri flussi di lavoro, usa il catalogo delle azioni. Questi flussi sono disponibili anche tramite il server MCP dell’account, tranne la creazione e la rotazione del segreto di firma dei webhook, che richiedono REST. Gestisci le credenziali in Integrazioni e consulta i limiti di utilizzo.

​
URL di base

Tutte le richieste API devono essere effettuate a:

​
Autenticazione

Autentica le chiamate REST private con una chiave API in x-api-key o Authorization: Bearer. Il documento OpenAPI è pubblico. Consulta Autenticazione per le credenziali con autorizzazioni specifiche e OAuth per MCP.

​
API di azioni JSON

Le sezioni account, team, progetti, voci e strumenti multimediali documentano ogni azione JSON separatamente. Tutte queste route usano POST, anche per leggere ed eliminare; invia gli argomenti nel corpo JSON. Le route per il caricamento di file e i progetti esistenti riportate sotto mantengono i propri metodi HTTP. Crea una chiave API con account:read, imposta la variabile d’ambiente VOICECHEAP_API_KEY e prova questa richiesta di sola lettura:
Un’azione completata restituisce HTTP 200 con il risultato in data. Un’azione lunga restituisce HTTP 202 e un requestId; consulta lo stato della richiesta per recuperare il risultato. Un processo multimediale può continuare dopo il completamento della richiesta di azione. Consulta tutte le azioni per area oppure scopri le azioni e gli schemi consentiti per la tua chiave. Ogni pagina indica autorizzazioni, parametri, esempi ed errori.

​
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.

​
Caricamento di file e route dei progetti esistenti

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.

Crea progetto

POST /v1/projectsCarica un file video o audio e avvia solo la trascrizione.

Avvia traduzione

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

Doppia progetto

POST /v1/projects/{projectId}/dubDoppia un progetto trascritto usando il tuo file SRT tradotto.

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

Le route esistenti per file e progetti riportate sotto mantengono i rispettivi formati di risposta. I campi delle risposte riuscite dipendono dall’endpoint. La creazione di un progetto e l’avvio del doppiaggio restituiscono success, message e projectId. Le richieste di stato e dettagli restituiscono lo stato del progetto; quelle di trascrizione restituiscono JSON, SRT o VTT. Consulta la pagina di ciascun endpoint per i campi esatti. Gli errori restituiscono un oggetto JSON con code e message, talvolta anche con details. Consulta i codici di errore.

​
Codici di stato HTTP