> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Iniciar Tradução

> Envie um arquivo de vídeo ou áudio e inicie um novo projeto de tradução

# Iniciar Tradução

Crie um novo projeto de tradução enviando um arquivo de vídeo ou áudio. O processo de tradução é executado de forma assíncrona em segundo plano. Use o [endpoint de status](https://api-docs.voicecheap.ai/docs/pt/api-reference/translation-status.md) para acompanhar o progresso e recuperar resultados. Use [Obter Detalhes do Projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/project-details.md) quando precisar do histórico da versão traduzida ou do histórico de sincronização labial.

## Limite de Simultaneidade

A criação de projetos, a tradução e a dublagem verificam o limite de traduções ativas da sua conta (no máximo 10, possivelmente menos). Apenas traduções ou dublagens em andamento ocupam vagas; projetos apenas de transcrição não ocupam. Ao atingir o limite, a API retorna `CONCURRENT_TRANSLATION_LIMIT_REACHED` (HTTP 429). O limite aplicado aparece em `details.limit`.

## Solicitação

Este endpoint aceita `multipart/form-data` com um upload de arquivo.

### Cabeçalhos

**x-api-key** `string` *required*

Sua chave de API VoiceCheap. Obtenha uma em [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Parâmetros do corpo

**file** `file` *required*

O arquivo de vídeo ou áudio a ser traduzido.

**Formatos de vídeo suportados:** `video/mp4`, `video/quicktime`, `video/x-matroska`, `video/webm`, `video/mpeg`

**Formatos de áudio suportados:** `audio/mpeg`, `audio/wav`, `audio/mp4`, `audio/x-m4a`, `audio/flac`, `audio/ogg`, `audio/aac`, `audio/webm`

**Tamanho máximo de arquivo por plano:** Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB e Enterprise 60 GB.

**targetLanguage** `string` *required*

O idioma para o qual o conteúdo será traduzido. Deve estar em letras minúsculas.

**Valores permitidos (70+):** `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`

**originalLanguage** `string`

O idioma de origem do conteúdo usando códigos de idioma ISO (por exemplo, `en`, `es`, `fr`, `de`, `ja`, `zh`).

> [!WARNING]
>
> **Altamente recomendado: Deixe este campo vazio para detecção automática.**
>
> Forneça este parâmetro apenas se tiver 100% de certeza de que o código do idioma está correto e no formato ISO válido. Códigos de idioma incorretos causarão falhas na transcrição. Nossa detecção automática suporta mais de 80 idiomas e é altamente precisa.

**Padrão:** `auto-detect`

**projectName** `string`

Um nome personalizado para o projeto. Útil para identificar projetos em seu painel.

**Padrão:** O ID do projeto será usado se não for fornecido.

**webhookUrl** `string`

Um endpoint https que recebe a [eventos de webhook](https://api-docs.voicecheap.ai/docs/pt/api-reference/webhooks.md) para este projeto,
substituindo o endpoint configurado em sua conta.

**Padrão:** O endpoint de webhook da conta, quando um estiver configurado.

**numberOfSpeakers** `string`

`auto-detect` ou um número inteiro de `1` a `32`. Uma contagem de falantes conhecida pode melhorar a diarização.

**Padrão:** `auto-detect`

**brandVocabulary** `string`

Uma matriz de strings JSON de nomes, marcas, siglas ou termos especializados específicos da solicitação. Esses termos são mesclados com o glossário salvo da conta ou da equipe.

**removeFillerWords** `boolean`

Remova palavras de preenchimento comuns da transcrição de origem antes da tradução.

**Padrão:** `true`

**sourceSrt** `string`

Uma transcrição SRT existente no idioma de origem. `originalLanguage` deve ser explícito quando este campo for fornecido.

**translatedSrt** `string`

O SRT final no idioma de destino, escrito por você. Quando informado, a VoiceCheap ignora o motor de tradução e apenas gera as vozes e mistura a saída a partir deste texto. Veja o [modo só de dublagem](#dub-only-mode-bring-your-own-translation) para as regras de alinhamento. Máximo de 1.000.000 de caracteres.

**keepBackgroundMusic** `boolean`

Se deve preservar o áudio de fundo na saída.

Quando ativado, mantém música de fundo, ambiente, risadas, aplausos e sons de multidão, removendo apenas a voz original (separação de stems). Desative se sua fonte não tiver áudio de fundo.

**Padrão:** `true`

**keepOriginalVoice** `boolean`

Mantenha o falante original em volume baixo sob a voz traduzida.

**Padrão:** `false`

**originalVoiceVolume** `number`

Volume da voz original de `1` a `70` quando `keepOriginalVoice` estiver ativado.

**Padrão:** `30`

**voiceIsolatorOption** `string` *deprecated*

Obsoleto. O isolamento de voz não é mais configurável: todos os projetos isolam as vozes da mesma forma. `studio` e `realistic` continuam sendo aceitos e não têm efeito.

**subtitles** `boolean`

Se deve gerar legendas para o vídeo traduzido.

Quando ativado, adiciona legendas legíveis em preto e branco. Use `subtitlesSource` para escolher o texto original (idioma de origem) ou traduzido (idioma de destino). As legendas são sincronizadas automaticamente para facilitar a leitura.

**Padrão:** `false`

**subtitlesSource** `string`

Escolha a fonte do texto das legendas quando `subtitles` estiver ativado.

**Valores permitidos:** `translated`, `original`

**Padrão:** `translated`

**Nota:** Se `original` for selecionado, mas a transcrição original não estiver disponível, as legendas usarão `translated` como alternativa.

**lipSyncMode** `string`

Aciona o processamento de sincronização labial após a conclusão da dublagem.

* `standard` = Lip Sync
* `pro` = Lip Sync Pro
* `studio` = Lip Sync Studio

Os modos premium aplicam seus requisitos normais de plano, duração e créditos.

**Padrão:** omita o campo para ignorar a sincronização labial.

**activeSpeakerDetectionEnabled** `boolean`

Ativa a detecção de orador ativo para a execução de sincronização labial solicitada.

**Padrão:** `false`

**lipsyncPro** `boolean`

Seletor de sincronização labial legado mantido para compatibilidade com versões anteriores.

* `false` = Sincronização labial padrão (**4 minutos de créditos por 1 minuto de vídeo**)
* `true` = Lip Sync Pro (**9 minutos de créditos por 1 minuto de vídeo**)

Lip Sync Pro está disponível a partir do plano Creator.

> [!WARNING]
>
> **Duração máxima:** 180 minutos por vídeo.
>
> **Latência:** O processamento de sincronização labial normalmente adiciona **2x-4x** a duração do vídeo original.

> [!NOTE]
>
> E-mails de conclusão e falha de sincronização labial não são enviados para solicitações acionadas por API. Use o [status endpoint](https://api-docs.voicecheap.ai/docs/pt/api-reference/translation-status.md) para
> acompanhar o progresso.

**Padrão:** não ativado (omita o campo para ignorar a sincronização labial)

**Form-data:** Envie valores booleanos como strings `true` ou `false` (por exemplo, `-F "lipsyncPro=false"`).

> [!WARNING]
>
> Não combine `lipsyncPro` com um `lipSyncMode` conflitante.

**voiceMode** `string`

Estratégia de voz: `cloning` ou `custom`.

**Padrão:** `cloning`

**voiceId** `string`

Obrigatório quando `voiceMode` é `custom`. Use um ID de `dubbing_voices_list`: uma voz do catálogo ou uma voz personalizada salva pela conta
autenticada. A cobrança da equipe não concede acesso às vozes salvas de outros membros.

**voiceCloningSettings** `object`

Ajuste os parâmetros de clonagem de voz para controle avançado sobre a voz gerada. Passe como uma string JSON ao usar form-data. Todos os valores devem estar entre 0 e 1 (com incremento de 0,01). Um valor `speakerBoost` enviado por integrações anteriores ainda é aceito, mas não tem mais nenhum efeito.

> [!NOTE]
>
> Estas configurações aplicam-se apenas quando `voiceMode` é `cloning`.

**propriedades voiceCloningSettings**

**stability** `number` (default: 0.65)

**Estabilidade da voz (0,00 - 1,00)**

Determina quão estável é a voz e a aleatoriedade entre cada geração.

* **Valores mais baixos** permitem uma gama emocional mais ampla, mas podem causar uma fala estranha ou apressada
* **Valores mais altos** produzem uma saída mais consistente, mas podem soar monótonos

**Padrão:** `0.65`

**similarity** `number` (default: 0.75)

**Similaridade da voz (0,00 - 1,00)**

Controla o quanto a IA adere à voz original.

* **Valores mais altos** tornam a voz clonada mais semelhante à original
* Se o áudio original for ruidoso e a similaridade for muito alta, artefatos ou ruído de fundo podem ser transferidos para a voz gerada

**Padrão:** `0.75`

**Valores padrão (equilibrados):**

```json theme={null}
{
  "stability": 0.6,
  "similarity": 0.8
}
```

**translationTimeSkips** `string`

Uma matriz JSON de intervalos de tempo de origem que devem permanecer no idioma original.

```json theme={null}
[
  { "startTime": 10.2, "endTime": 12.8 }
]
```

Pulos de tempo exigem entrada de vídeo e `keepBackgroundMusic=true`. Eles não podem ser combinados com `keepOriginalVoice` e não podem sobrepor segmentos de transcrição.

## Modo só de dublagem (traga a sua tradução)

Envie `translatedSrt` quando a tradução já existir e a VoiceCheap só precisar gerar as vozes e mixar a saída.
Neste modo:

* **Sem tradução por IA e sem reformulação SmartSync.** Cada cue é falado literalmente. Regras de glossário salvas e instruções de tradução personalizadas também não se aplicam, porque só são executadas no motor de tradução.
* **O tempo vem da fonte.** Cada segmento mantém o início, o fim e o locutor da transcrição de origem; os timecodes do seu SRT servem apenas para associar cues a segmentos. A fala gerada é esticada ou comprimida para caber na janela do segmento, sem reformular o texto.
* **Os mesmos créditos de uma tradução.** A execução é cobrada exatamente como uma tradução padrão da mesma mídia.
* **As opções de voz, fundo, legendas e sincronização labial continuam valendo.** `voiceMode`, `keepBackgroundMusic`, `subtitles`, `lipSyncMode` e as outras opções de dublagem se comportam como documentado acima.

O `message` da resposta confirma o modo, e a versão traduzida informa `dubbingMode: "dub-only"` em
[Obter Detalhes do Projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/project-details.md).

### Regras de alinhamento

| Solicitação | Modo | Regra |
| - | - | - |
| `translatedSrt` + `sourceSrt` | `index` | Os dois arquivos devem conter o mesmo número de cues; o cue *n* da tradução é falado no cue *n* da fonte. Uma diferença de contagem é rejeitada antes do envio com `TRANSLATED_SRT_CUE_COUNT_MISMATCH`. |
| apenas `translatedSrt` | `timestamps` | A mídia é transcrita primeiro e depois cada cue traduzido é associado ao segmento da transcrição que começa dentro de 50 ms do início do cue, ou ao de maior sobreposição. Vários cues no mesmo segmento são unidos. Um cue sem segmento ou um segmento sem cue faz a execução falhar. |

Os problemas de alinhamento no modo `timestamps` só são conhecidos após a transcrição e são reportados de forma assíncrona. O [endpoint de status](https://api-docs.voicecheap.ai/docs/pt/api-reference/translation-status.md) devolve HTTP 200 com `status: "failed"` e um `error` com `code` e `message`; o [webhook](https://api-docs.voicecheap.ai/docs/pt/api-reference/webhooks.md) `project.translation.failed` inclui o mesmo código e mensagem. Em `TRANSLATED_SRT_UNMATCHED_CUES`, os números dos cues sem correspondência aparecem na mensagem; em `TRANSLATED_SRT_MISSING_SEGMENTS`, aparecem os índices dos segmentos sem cue. Estas respostas não incluem um campo `details` estruturado. Para um mapeamento determinístico, envie `sourceSrt` com `translatedSrt` ou crie primeiro o projeto com [Criar projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/create-project.md), exporte a transcrição, traduza-a cue a cue e chame [Dublar o projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/dub-project.md).

### Verificar o ritmo

Frases longas precisam ser aceleradas para caber no segmento. Exporte a transcrição traduzida com
[Exportar transcrição do projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/project-transcript.md): cada segmento traduzido traz `finalSpeedFactor`, a
razão entre a fala gerada e a janela do segmento antes do ajuste final de tempo. Encurte os cues que ficarem acima de cerca de
`1.3` e execute a dublagem de novo com o SRT revisado.

> [!NOTE]
>
> `translatedSrt` também é aceito no endpoint JSON [Dublar o projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/dub-project.md), que dubla um
> projeto já transcrito sem enviar a mídia outra vez.

## Resposta

**success** `boolean` *required*

Sempre `true` para solicitações bem-sucedidas

**message** `string` *required*

Uma mensagem legível por humanos descrevendo o resultado

**projectId** `string` *required*

O identificador único para o projeto de tradução criado. Use este ID para verificar o status.

**estimatedDuration** `number` *required*

Estimativa aproximada de processamento em minutos. A estimativa atual é de cinco minutos de processamento por minuto iniciado de mídia de origem.

## Exemplos

> [!NOTE]
>
> Regras de glossário salvas e instruções de tradução personalizadas da conta ou equipe efetiva são aplicadas automaticamente.

```bash cURL theme={null}
curl -X POST https://api.voicecheap.ai/v1/translate \
  -H "x-api-key: vc_your-api-key" \
  -F "file=@video.mp4" \
  -F "targetLanguage=spanish" \
  -F "projectName=My Spanish Translation" \
  -F "numberOfSpeakers=2" \
  -F 'brandVocabulary=["VoiceCheap","SmartSync"]' \
  -F "removeFillerWords=true" \
  -F "keepBackgroundMusic=true" \
  -F "keepOriginalVoice=false" \
  -F "subtitles=true" \
  -F "subtitlesSource=translated" \
  -F "lipSyncMode=standard" \
  -F "activeSpeakerDetectionEnabled=true"
```

```typescript TypeScript theme={null}
interface StartTranslationResponse {
  success: boolean;
  message: string;
  projectId: string;
  estimatedDuration: number;
}

interface VoiceCloningSettings {
  stability: number; // 0.00 - 1.00
  similarity: number; // 0.00 - 1.00
}

interface StartTranslationRequest {
  targetLanguage: string;
  originalLanguage?: string;
  projectName?: string;
  numberOfSpeakers?: 'auto-detect' | string;
  brandVocabulary?: string[];
  removeFillerWords?: boolean;
  sourceSrt?: string;
  translatedSrt?: string;
  keepBackgroundMusic?: boolean;
  keepOriginalVoice?: boolean;
  originalVoiceVolume?: number;
  voiceMode?: 'cloning' | 'custom';
  voiceId?: string;
  subtitles?: boolean;
  subtitlesSource?: 'translated' | 'original';
  lipSyncMode?: 'standard' | 'pro' | 'studio';
  activeSpeakerDetectionEnabled?: boolean;
  voiceCloningSettings?: VoiceCloningSettings;
  translationTimeSkips?: Array<{ startTime: number; endTime: number }>;
}

async function startTranslation(
  file: File,
  targetLanguage: string,
  options?: {
    originalLanguage?: string;
    projectName?: string;
    numberOfSpeakers?: 'auto-detect' | string;
    brandVocabulary?: string[];
    removeFillerWords?: boolean;
    sourceSrt?: string;
    translatedSrt?: string;
    keepBackgroundMusic?: boolean;
    keepOriginalVoice?: boolean;
    originalVoiceVolume?: number;
    voiceMode?: 'cloning' | 'custom';
    voiceId?: string;
    subtitles?: boolean;
    subtitlesSource?: 'translated' | 'original';
    lipSyncMode?: 'standard' | 'pro' | 'studio';
    activeSpeakerDetectionEnabled?: boolean;
    voiceCloningSettings?: VoiceCloningSettings;
    translationTimeSkips?: Array<{ startTime: number; endTime: number }>;
  },
): Promise<StartTranslationResponse> {
  const formData = new FormData();
  formData.append('file', file);
  formData.append('targetLanguage', targetLanguage);

  if (options?.projectName) {
    formData.append('projectName', options.projectName);
  }
  if (options?.originalLanguage) {
    formData.append('originalLanguage', options.originalLanguage);
  }
  if (options?.numberOfSpeakers) {
    formData.append('numberOfSpeakers', options.numberOfSpeakers);
  }
  if (options?.brandVocabulary) {
    formData.append('brandVocabulary', JSON.stringify(options.brandVocabulary));
  }
  if (options?.removeFillerWords !== undefined) {
    formData.append('removeFillerWords', String(options.removeFillerWords));
  }
  if (options?.sourceSrt) {
    formData.append('sourceSrt', options.sourceSrt);
  }
  if (options?.translatedSrt) {
    formData.append('translatedSrt', options.translatedSrt);
  }
  if (options?.keepBackgroundMusic !== undefined) {
    formData.append('keepBackgroundMusic', String(options.keepBackgroundMusic));
  }
  if (options?.keepOriginalVoice !== undefined) {
    formData.append('keepOriginalVoice', String(options.keepOriginalVoice));
  }
  if (options?.originalVoiceVolume !== undefined) {
    formData.append('originalVoiceVolume', String(options.originalVoiceVolume));
  }
  if (options?.voiceMode) {
    formData.append('voiceMode', options.voiceMode);
  }
  if (options?.voiceId) {
    formData.append('voiceId', options.voiceId);
  }
  if (options?.subtitles !== undefined) {
    formData.append('subtitles', String(options.subtitles));
  }
  if (options?.subtitlesSource) {
    formData.append('subtitlesSource', options.subtitlesSource);
  }
  if (options?.lipSyncMode) {
    formData.append('lipSyncMode', options.lipSyncMode);
  }
  if (options?.activeSpeakerDetectionEnabled !== undefined) {
    formData.append('activeSpeakerDetectionEnabled', String(options.activeSpeakerDetectionEnabled));
  }
  if (options?.voiceCloningSettings) {
    formData.append('voiceCloningSettings', JSON.stringify(options.voiceCloningSettings));
  }
  if (options?.translationTimeSkips) {
    formData.append('translationTimeSkips', JSON.stringify(options.translationTimeSkips));
  }

  const response = await fetch('https://api.voicecheap.ai/v1/translate', {
    method: 'POST',
    headers: {
      'x-api-key': 'vc_your-api-key',
    },
    body: formData,
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message || 'Translation failed');
  }

  return response.json();
}

// Usage example
const file = document.querySelector<HTMLInputElement>('#fileInput')?.files?.[0];
if (file) {
  const result = await startTranslation(file, 'spanish', {
    projectName: 'My Spanish Translation',
    keepBackgroundMusic: true,
    subtitles: true,
    subtitlesSource: 'translated',
    voiceCloningSettings: {
      stability: 0.6,
      similarity: 0.85,
    },
  });
  console.log('Project ID:', result.projectId);
}
```

```javascript JavaScript theme={null}
const formData = new FormData();
formData.append('file', videoFile);
formData.append('targetLanguage', 'spanish');
formData.append('projectName', 'My Spanish Translation');
formData.append('keepBackgroundMusic', 'true');
formData.append('subtitles', 'true');
formData.append('subtitlesSource', 'translated');
formData.append(
  'voiceCloningSettings',
  JSON.stringify({
    stability: 0.6,
    similarity: 0.85,
  }),
);

const response = await fetch('https://api.voicecheap.ai/v1/translate', {
  method: 'POST',
  headers: {
    'x-api-key': 'vc_your-api-key',
  },
  body: formData,
});

const data = await response.json();
console.log('Project ID:', data.projectId);
```

```python Python theme={null}
import requests
import json

files = {'file': open('video.mp4', 'rb')}
data = {
    'targetLanguage': 'spanish',
    'projectName': 'My Spanish Translation',
    'keepBackgroundMusic': 'true',
    'subtitles': 'true',
    'subtitlesSource': 'translated',
    'voiceCloningSettings': json.dumps({
        'stability': 0.60,
        'similarity': 0.85
    })
}
headers = {'x-api-key': 'vc_your-api-key'}

response = requests.post(
    'https://api.voicecheap.ai/v1/translate',
    headers=headers,
    files=files,
    data=data
)

result = response.json()
print(f"Project ID: {result['projectId']}")
```

```php PHP theme={null}
<?php
$curl = curl_init();

$voiceCloningSettings = json_encode([
    'stability' => 0.60,
    'similarity' => 0.85
]);

$postFields = [
    'file' => new CURLFile('video.mp4'),
    'targetLanguage' => 'spanish',
    'projectName' => 'My Spanish Translation',
    'keepBackgroundMusic' => 'true',
    'subtitles' => 'true',
    'subtitlesSource' => 'translated',
    'voiceCloningSettings' => $voiceCloningSettings
];

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.voicecheap.ai/v1/translate',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $postFields,
    CURLOPT_HTTPHEADER => [
        'x-api-key: vc_your-api-key'
    ]
]);

$response = curl_exec($curl);
$result = json_decode($response, true);
echo "Project ID: " . $result['projectId'];
```

## Exemplo de Resposta

```json theme={null}
{
  "success": true,
  "message": "Translation started successfully. Use the status endpoint to track progress.",
  "projectId": "abc123-def456-ghi789",
  "estimatedDuration": 15
}
```

## Erros

| Status | Código | Descrição |
| - | - | - |
| 400 | `FILE_REQUIRED` | Nenhum arquivo foi enviado com a solicitação |
| 400 | `INVALID_FILE_TYPE` | O tipo de arquivo enviado não é suportado |
| 400 | `DURATION_DETECTION_FAILED` | Não foi possível detectar a duração do arquivo enviado |
| 400 | `INVALID_MULTIPART_REQUEST` | Os dados do formulário multipart estão malformados ou excedem os limites de campo |
| 400 | `INVALID_BOOLEAN_VALUE` | Um parâmetro booleano tem um valor inválido (use "true" ou "false") |
| 400 | `INVALID_JSON_FORMAT` | O JSON voiceCloningSettings está malformado |
| 400 | `INVALID_BRAND_VOCABULARY` | Uma entrada de vocabulário específica da solicitação é inválida |
| 400 | `INVALID_SOURCE_SRT` | O SRT de origem fornecido está malformado |
| 400 | `SOURCE_LANGUAGE_REQUIRED_FOR_SRT` | sourceSrt requer um originalLanguage explícito |
| 400 | `INVALID_TRANSLATED_SRT` | O SRT traduzido enviado está malformado |
| 400 | `TRANSLATED_SRT_CUE_COUNT_MISMATCH` | translatedSrt e sourceSrt não contêm o mesmo número de cues |
| 400 | `VOICE_ID_REQUIRED` | O modo de vozes personalizadas foi selecionado sem um ID de voz |
| 400 | `VOICE_ID_NOT_ALLOWED_WITH_CLONING` | Um ID de voz foi combinado com clonagem de voz |
| 400 | `VOICE_CLONING_SETTINGS_NOT_ALLOWED` | As configurações de clone foram combinadas com o modo de vozes personalizadas |
| 400 | `CONFLICTING_LIPSYNC_OPTIONS` | lipSyncMode entra em conflito com o lipsyncPro legado |
| 400 | `TRANSLATION_TIME_SKIP_CONFLICT` | Pulos de tempo entram em conflito com outra opção de áudio |
| 400 | `TRANSLATION_TIME_SKIP_REQUIRES_BACKGROUND` | Pulos de tempo requerem áudio de fundo |
| 400 | `TRANSLATION_TIME_SKIP_OUT_OF_RANGE` | Um pulo de tempo se estende além da duração da mídia |
| 400 | `INVALID_TRANSLATION_TIME_SKIPS` | Um pulo de tempo se sobrepõe a um segmento de transcrição |
| 400 | `SUBTITLES_NOT_AVAILABLE_FOR_AUDIO` | Legendas embutidas foram solicitadas para entrada de áudio |
| 400 | `LIPSYNC_NOT_AVAILABLE_FOR_AUDIO` | Sincronização labial foi solicitada para entrada de áudio |
| 400 | `TRANSLATION_TIME_SKIP_NOT_AVAILABLE_FOR_AUDIO` | Pulos de tempo foram solicitados para entrada de áudio |
| 400 | `LIPSYNC_VIDEO_TOO_LONG` | Sincronização labial foi solicitada para mídia com duração superior à suportada |
| 413 | `FILE_TOO_LARGE` | O arquivo enviado excede o limite do plano do usuário |
| 401 | `MISSING_API_KEY` | A chave de API é necessária |
| 401 | `INVALID_API_KEY_FORMAT` | A chave de API deve começar com `vc_` |
| 401 | `INVALID_API_KEY` | A chave de API fornecida é inválida |
| 403 | `SUBSCRIPTION_REQUIRED` | O acesso à API requer um plano Starter ou superior |
| 403 | `INSUFFICIENT_CREDITS` | Créditos insuficientes para processar este arquivo |
| 403 | `CUSTOM_VOICE_ACCESS_DENIED` | A voz selecionada não é uma voz do catálogo nem uma voz personalizada salva pela conta autenticada. |
| 403 | `LIPSYNC_MODE_ACCESS_DENIED` | O modo de sincronização labial premium não está disponível no plano atual |
| 429 | `RATE_LIMIT_EXCEEDED` | Muitas solicitações (limite: 10 solicitações por minuto) |
| 429 | `CONCURRENT_TRANSLATION_LIMIT_REACHED` | Limite de traduções simultâneas da conta atingido; consulte `details.limit` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.