Skip to main content
POST
Traduci e doppia un progetto già trascritto in un’altra lingua con i normali controlli su crediti, voci e concorrenza. 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
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 nella lingua di destinazione dopo l’ammissione della traduzione e del doppiaggio di un progetto esistente già trascritto.

​
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

  • Richiede una trascrizione originale completata e non vuota. Il progetto archiviato fornisce la durata e il tipo del contenuto multimediale.
  • Riutilizza il lavoro linguistico esistente, se presente, altrimenti lo crea. Un doppiaggio concorrente in quella lingua deve terminare prima che ne inizi un altro.
  • Questa azione non accetta sourceSrt, translatedSrt, 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.

​
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