Skip to main content
POST
Genera la voce per il tuo SRT nella lingua di destinazione in un progetto trascritto esistente. La voce e la sincronizzazione labiale facoltativa usano i normali crediti multimediali. Interroga projects_status.

​
Autenticazione e autorizzazioni

​
string
obbligatorio
Invia una chiave API VoiceCheap in questa intestazione. È supportato anche Authorization: Bearer con la stessa chiave API. I token di accesso OAuth sono accettati solo da MCP, non da questo endpoint REST.
Autorizzazioni richieste: translations:write. È necessario un abbonamento a pagamento attivo. Le autorizzazioni non modificano i ruoli del team, la proprietà delle risorse, i crediti multimediali o i limiti del piano.

​
Parametri

​
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 200. Pattern: ^[^/\\]+$.
​
boolean
Valore booleano.
​
boolean
Valore booleano.
​
number
Valore numerico.Minimo: 1. Massimo: 70.
​
string
Valore testuale.Valori consentiti: “cloning”, “custom”.
​
string
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 128.
​
boolean
Valore booleano.
​
string
Valore testuale.Valori consentiti: “translated”, “original”.
​
string
Valore testuale.Valori consentiti: “studio”, “realistic”.
​
string
Valore testuale.Valori consentiti: “standard”, “pro”, “studio”.
​
boolean
Valore booleano.
​
object
Oggetto JSON. Consulta lo schema di input completo per i campi annidati.
​
array
Elenco di valori. Consulta lo schema di input completo per la struttura degli elementi.Numero massimo di elementi: 100.
​
string
obbligatorio
Valore testuale.Valori consentiti: “afrikaans”, “albanian”, “amharic”, “arabic”, “armenian”, “assamese”, “azerbaijani”, “basque”, “belarusian”, “bengali”, “bosnian”, “bulgarian”, “catalan”, “croatian”, “czech”, “danish”, “dutch”, “english”, “british english”, “estonian”, “finnish”, “french”, “french canadian”, “galician”, “german”, “greek”, “gujarati”, “hebrew”, “hindi”, “hungarian”, “icelandic”, “indonesian”, “irish”, “italian”, “japanese”, “kannada”, “kazakh”, “khmer”, “korean”, “lao”, “latvian”, “lithuanian”, “macedonian”, “malay”, “malayalam”, “mandarin”, “marathi”, “mongolian”, “nepali”, “norwegian”, “persian”, “polish”, “portuguese”, “brazilian portuguese”, “pt_brazil”, “punjabi”, “romanian”, “russian”, “serbian”, “slovak”, “slovenian”, “spanish”, “swahili”, “swedish”, “tagalog”, “tamil”, “telugu”, “thai”, “turkish”, “ukrainian”, “urdu”, “vietnamese”, “welsh”, “yoruba”, “zulu”.
​
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 1000000.
​
string
Facoltativo al livello di trasporto: se omesso, il server inserisce un identificatore prima della validazione. Fornisci un tuo UUID v4 stabile per recuperare in sicurezza una risposta persa.Formato: “uuid”. Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$.
Il JSON Schema seguente conserva i nomi esatti dei campi, i tipi annidati, i valori predefiniti, i limiti e i valori accettati esposti dalla discovery. Le ulteriori regole tra campi sono elencate nelle note sull’operazione.

​
Idempotenza

Usa un UUID v4 in requestId o nell’intestazione HTTP Idempotency-Key per ogni modifica. Riutilizza lo stesso identificatore e argomenti identici dopo un errore di rete. Se vengono forniti entrambi, devono coincidere. Ripetere una richiesta salvata non ripete l’operazione e non consuma un’altra chiamata mensile. Le richieste non riuscite o interrotte non vengono riavviate automaticamente. Ogni modifica può restituire HTTP 202 quando un nuovo tentativo trova la stessa richiesta ancora in esecuzione, anche se la prima esecuzione è normalmente sincrona. Se l’esecuzione è completata ma resultStored è false, un nuovo tentativo restituisce HTTP 200 con lo stato della richiesta salvata anziché il risultato originale. Recupera l’output tramite l’azione di cronologia, risultato o download del relativo dominio.

​
Esempi di richiesta

Sostituisci gli identificatori delle risorse e le chiavi multimediali di esempio con i valori restituiti per il tuo account. Mantieni stabile l’identificatore della richiesta quando ripeti la stessa modifica.

​
Risposta

Una prima esecuzione riuscita restituisce HTTP 200 con il risultato dell’operazione in data. Una ripetizione può invece restituire lo stato della richiesta salvata. L’esempio mostra una risposta supportata, non tutti i campi facoltativi. Restituisce gli identificatori del progetto e del lavoro linguistico dopo aver ammesso la generazione vocale da un SRT nella lingua di destinazione fornito dal chiamante.

​
Campi del risultato

​
Recupera e monitora questa richiesta

Usa lo stesso identificatore anche dopo una connessione persa. Se resultStored è false, recupera l’output tramite la corrispondente azione di cronologia, risultato o download. Non avviare mai una seconda generazione solo per verificarne l’avanzamento.
HTTP 200

​
Note sull’operazione

  • translatedSrt è obbligatorio e deve contenere blocchi SRT validi. Questa azione richiede una trascrizione originale completata. I blocchi vengono associati ai segmenti sorgente esistenti in base all’ora di inizio con una tolleranza di 0.05 secondi, ricorrendo alla maggiore sovrapposizione temporale se necessario; i tempi dell’output usano sempre la timeline dei segmenti originali.
  • Il lavoro nella lingua di destinazione viene riutilizzato o creato. Il testo fornito viene doppiato senza traduzione automatica né SmartSync.
  • Nessun contenuto multimediale sorgente viene caricato di nuovo. Il progetto memorizzato fornisce la durata e il tipo audio/video.
  • Questa azione non accetta sourceSrt, fileKey, un URL multimediale o webhookUrl.
  • voiceMode usa cloning per impostazione predefinita. Con voiceMode custom, usa una voce del catalogo o una voce personalizzata salvata dall’account autenticato; non inviare voiceCloningSettings. La fatturazione del team non concede accesso alle voci salvate degli altri membri.
  • I campi facoltativi subtitles, lipSyncMode e translationTimeSkips richiedono un input video. Gli intervalli saltati devono rimanere entro la durata del contenuto multimediale, keepBackgroundMusic deve essere true e keepOriginalVoice deve essere false.
  • lipSyncMode accetta standard, pro o studio, nel rispetto del piano e dei normali controlli sui crediti multimediali. La generazione vocale e la sincronizzazione labiale non diventano gratuite quando le chiamate API mensili sono illimitate.
  • Interroga periodicamente projects_status per il flusso di lavoro multimediale; recupera tutte le versioni linguistiche con projects_get.
  • Un blocco di sottotitoli senza segmento sorgente corrispondente, o un segmento sorgente senza testo fornito, può causare un errore nella pipeline in background; dopo l’ammissione, controlla projects_status.error o il campo translations di projects_get.

​
Utilizzo

Ogni invocazione riuscita consuma una chiamata API/MCP mensile. Si applicano anche i crediti multimediali e le quote di generazione proprie dell’operazione.

​
Errori