Skip to main content
POST
Aggiungi un modello di sottotitoli dinamici selezionato a un video tradotto o con sincronizzazione labiale completato. Si applicano la normale quota del piano e i crediti multimediali. Interroga projects_get.

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: subtitles: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: ^[^/\\]+$.
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 200. Pattern: ^[^/\\]+$.
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 200. Pattern: ^[^/\\]+$.
string
obbligatorio
Valore testuale.Valori consentiti: “Sara”, “Daniel”, “Dan 2”, “Hormozi 4”, “Dan”, “Devin”, “Tayo”, “Ella”, “Tracy”, “Luke”, “Hormozi 1”, “Hormozi 2”, “Hormozi 3”, “Hormozi 5”, “Leon”, “Ali”, “Beast”, “Maya”, “Karl”, “Iman”, “Umi”, “David”, “Noah”, “Gstaad”, “Malta”, “Nema”, “Seth”, “William”.
string
Valore testuale.Valori consentiti: “translated”, “lip-synced”. Valore predefinito: “translated”.
boolean
Valore booleano.Valore predefinito: false.
boolean
Valore booleano.Valore predefinito: false.
number
Valore numerico.Minimo: 0. Massimo: 100. Valore predefinito: 0.
string
Valore testuale.Valori consentiti: “natural”, “fast”, “extra-fast”.
boolean
Valore booleano.
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

Questa operazione restituisce HTTP 202 mentre è in esecuzione. Salva requestId e interroga action_request_get con questo identificatore e il nome dell’operazione originale. Gli stati del polling sono running, completed, failed e interrupted. Un risultato completato può rimandare a un processo multimediale separato; prosegui con l’azione di stato o di output specifica dell’operazione. Restituisce gli identificatori del progetto, del lavoro e della versione selezionati con lo stato di elaborazione dopo l’ammissione dei sottotitoli dinamici.

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

  • templateName è il nome di un modello supportato. videoSource è translated per impostazione predefinita; lip-synced seleziona l’ultimo video lip-sync completato e memorizzato. Gli URL multimediali forniti dal chiamante non sono accettati.
  • La versione selezionata deve essere completata e il video selezionato deve essere disponibile. Sono supportati MP4 e MOV; la durata memorizzata del progetto deve essere al massimo di 2 ore e la dimensione memorizzata in byte al massimo di 2 GiB.
  • magicZooms e magicBrolls sono false per impostazione predefinita; magicBrollsPercentage è 0 per impostazione predefinita. Il campo facoltativo removeSilencePace accetta natural, fast o extra-fast; removeBadTakes è un booleano.
  • La lingua proviene dal lavoro linguistico autorizzato. Si applicano i normali controlli sui limiti del piano e sui crediti multimediali; una traduzione può rigenerare i sottotitoli dinamici una sola volta.
  • Questa azione richiede un’esecuzione prolungata. Interroga periodicamente prima action_request_get per il completamento del gestore, quindi projects_get.translations[].dynamicSubtitles per inProgress, videoUrl ed errorMessage. projects_status non espone questo stato dei sottotitoli dinamici.

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