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

# Visão geral

> API de Tradução visual

## Entradas e Saídas

Entrada:

* video\_url
* idioma de origem e idioma de destino
* \[opcional] glossary\_ids
* \[opcional] user\_prompt
* \[opcional] project\_mode

Saída:

* video\_url traduzido
* project\_url quando `project_mode` for `editable`

## Como funciona

<Steps>
  <Step title="Hospede seu vídeo em uma URL acessível publicamente">
    Envie seu vídeo de entrada para que nossos servidores possam recuperá-lo. O vídeo não deve ter mais de 20 minutos.
  </Step>

  <Step title="Envie uma solicitação de Tradução visual">
    Inclua os códigos de idioma de origem e de destino, além de IDs de glossário opcionais ou instruções de prompt para terminologia e estilo.
  </Step>

  <Step title="Aguarde ou consulte o status">
    Use o callback do seu webhook ou consulte a API com o ID da tarefa retornado até que o processamento seja concluído.
  </Step>

  <Step title="Baixe o vídeo traduzido">
    Quando a tarefa estiver concluída, recupere o vídeo traduzido em `video_url`. Se você criou um projeto editável, abra `project_url` para revisá-lo ou editá-lo no Painel de Controle da web.
  </Step>
</Steps>

## Limitações de uso

* Somente usuários que podem criar chaves de API podem usar esta API.
* O Plano Studio é obrigatório; usuários não Studio não são permitidos.
* A entrada deve ser um arquivo de vídeo. A exportação somente de áudio não é compatível.
* A duração máxima de entrada compatível é de 20 minutos.
* A detecção automática do idioma de origem não é compatível. Forneça explicitamente um código de idioma de origem compatível.
* O código de idioma segue o padrão IETF BCP 47, por exemplo, `en-US`, `zh-CN`, `zh-CN-GUANGXI`.

## Códigos de erro da API

| Código | Descrição                                                           |
| ------ | ------------------------------------------------------------------- |
| 5      | Parâmetros de solicitação inválidos.                                |
| 7      | Sem permissão para solicitar.                                       |
| 104    | Créditos insuficientes.                                             |
| 814    | Sua conta não é membro e não tem permissão para chamar a API.       |
| 1000   | Erro interno do servidor.                                           |
| 1301   | A verificação de desafio do callback falhou.                        |
| 1302   | A chave de API foi revogada.                                        |
| 1304   | A chave de API atingiu o número máximo de solicitações simultâneas. |
| 1503   | Sua conta não está autorizada a chamar a API.                       |
| 1305   | Somente o Plano Studio é permitido.                                 |

## Códigos de erro da tarefa

| Código | Descrição                                      |
| ------ | ---------------------------------------------- |
| 40002  | O arquivo enviado não possui fluxo de vídeo.   |
| 40010  | A transcodificação falhou.                     |
| 40050  | A tradução falhou.                             |
| 40020  | A extração de OCR falhou.                      |
| 40032  | Não há callouts válidos no vídeo.              |
| 40040  | A correspondência entre OCR e callouts falhou. |
| 40041  | Falha ao corresponder qualquer callout ao OCR. |
| 40060  | Falha ao refinar os callouts.                  |
| 40061  | Falha ao extrair o estilo no refinamento.      |
| 40080  | A geração do vídeo de pré-visualização falhou. |