Skip to main content
POST
Pubblica o programma una traduzione completata, un output con sincronizzazione labiale o un output con sottotitoli dinamici su uno dei tuoi canali connessi. L’URL del video proviene dalla versione archiviata selezionata.

​
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: publishing:write, projects:read. È 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: “youtube”, “tiktok”.
​
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 200. Pattern: ^[^/\\]+$.
​
string
Valore testuale.Valori consentiti: “translated”, “lip-synced”, “dynamic-subtitles”. Valore predefinito: “translated”.
​
string
obbligatorio
Valore testuale.Lunghezza minima: 1. Lunghezza massima: 100.
​
string
Valore testuale.Lunghezza massima: 5000.
​
string
Valore testuale.Valori consentiti: “public”, “unlisted”, “private”. Valore predefinito: “private”.
​
string
Valore testuale.Valori consentiti: “PUBLIC_TO_EVERYONE”, “MUTUAL_FOLLOW_FRIENDS”, “FOLLOWER_OF_CREATOR”, “SELF_ONLY”. Valore predefinito: “SELF_ONLY”.
​
string
Valore testuale.Formato: “date-time”. Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$.
​
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 un’identità e un timestamp della pubblicazione pianificata oppure un’identità e un URL del video pubblicato immediatamente.

​
Campi del risultato

​
scheduledAt viene omesso e il servizio di pubblicazione immediata si conclude.

Restituisce l’identità del tentativo di pubblicazione immediata e le informazioni sul video della piattaforma.
HTTP 200

​
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

  • Questa azione pubblica esternamente. Seleziona un canale appartenente all’utente autenticato; l’accesso ai contenuti multimediali dei progetti del team non concede accesso al canale di un altro membro.
  • Il valore predefinito di videoSource è translated. lip-synced seleziona l’ultimo video completato con sincronizzazione labiale; dynamic-subtitles seleziona l’output memorizzato dei sottotitoli dinamici. La versione deve essere nello stato completed e l’output scelto deve esistere.
  • L’integrazione usa per impostazione predefinita YouTube private e TikTok SELF_ONLY. L’URL del video proviene dalla versione memorizzata autorizzata, non da un URL fornito dal chiamante.
  • scheduledAt è opzionale. Se fornito, deve essere una data e ora ISO valida con un offset e strettamente futura; il gestore ne restituisce il valore in millisecondi Unix. In sua assenza, questa azione pubblica immediatamente.
  • Questa azione richiede un’esecuzione prolungata. Interroga periodicamente action_request_get per ottenere il risultato del gestore e publishing_list per lo stato successivo della pubblicazione. Le risposte programmate e immediate hanno campi diversi.
  • Il gestore immediato riporta lo stato published con il videoId restituito dal servizio di pubblicazione sui social e il videoUrl facoltativo. La risposta della pianificazione in coda non contiene videoId né videoUrl.
  • Per TikTok, videoId può essere l’identificatore di pubblicazione della piattaforma quando l’ID numerico finale del video non è disponibile; videoUrl può usare come alternativa l’URL del canale connesso o il video di origine archiviato.

​
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