> ## 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

> Crie LipSync ou Fotos Falantes com o Modelo LipSync Reutilizável

## Por que usar a API LipSync Reutilizável?

A API LipSync Reutilizável é uma versão otimizada da nossa API LipSync, projetada para desenvolvedores que frequentemente geram vídeos dublados usando a mesma referência visual.

### O que há de diferente?

| Feature               | LipSync API                         | Reusable LipSync API                        |
| :-------------------- | :---------------------------------- | :------------------------------------------ |
| Upload de referência  | Necessário para cada solicitação    | Faça upload uma vez, reutilize várias vezes |
| Etapa de treinamento  | Necessária                          | Não necessária                              |
| Entrada para geração  | Referência + áudio                  | Apenas áudio (referência reutilizada)       |
| Velocidade de geração | Padrão                              | Muito mais rápida (sem re-treinamento)      |
| Custo por solicitação | 5 pontos base + 5 pontos por minuto | 5 pontos por minuto                         |

## Como funciona

<Steps>
  <Step title="Crie um modelo usando o ID da tarefa anterior">
    Crie um modelo de lip sync reutilizável usando o ID da tarefa anterior da API de lip sync em modo de precisão.
  </Step>

  <Step title="Hospede seus ativos de áudio em uma URL acessível publicamente">
    Faça upload do seu arquivo de áudio para que nossos servidores possam recuperá-lo.
  </Step>

  <Step title="Envie uma solicitação de API com os parâmetros apropriados">
    Referencie seus ativos hospedados e especifique o modo desejado (Padrão ou Precisão).
  </Step>

  <Step title="Aguarde ou consulte o status">
    Use nosso callback de webhook ou consulte a API com seu ID de trabalho até que o processamento esteja completo.
  </Step>

  <Step title="Baixe a saída de vídeo">
    Recupere a foto falante ou o vídeo sincronizado de lábios terminado a partir da URL fornecida.
  </Step>
</Steps>

## Limitação de Uso:

* Você pode ter até 10 trabalhos simultâneos (incluindo solicitações em fila).
* Tempo estimado de espera: 1–120 minutos, dependendo da carga do sistema.
* Tempo de processamento: \~10 minutos.

<Note>
  Se um vídeo ou foto contiver múltiplos rostos, apenas o maior rosto detectado será sincronizado.
</Note>

## Política de Expiração de Modelos

Modelos criados através da API de Criação de Modelos têm um mecanismo automático de expiração baseado na atividade.

### Regras

1. Período de Expiração Padrão Cada modelo de lipsync reutilizável permanece ativo por 3 meses a partir da sua data de criação ou último uso.
2. Extensão Automática Toda vez que o modelo de lipsync reutilizável é usado (por exemplo, chamado em uma solicitação de API de lipsync reutilizável), sua data de expiração é estendida por mais 3 meses a partir desse ponto no tempo.
3. Expiração Se um modelo de lipsync reutilizável não for utilizado por 3 meses consecutivos, ele expirará automaticamente e poderá ser excluído permanentemente.
4. Reativação Modelos de lipsync reutilizáveis expirados não podem ser reativados. Para continuar usando a mesma configuração, você deve reenviar o trabalho de lipsync e recriar o modelo de lipsync reutilizável através da API.

## 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 é um membro e não tem permissão para chamar a API.                           |
| 1000   | Erro Interno do Servidor.                                                                  |
| 1301   | Falha no Desafio de Callback.                                                              |
| 1302   | A chave da API foi revogada.                                                               |
| 1304   | A chave da API atingiu o número máximo de solicitações simultâneas.                        |
| 1502   | Seu driver de áudio é inválido ou não pode ser baixado.                                    |
| 1503   | Sua conta não está autorizada a chamar a API.                                              |
| 1504   | A criação de tarefas não é suportada no modo Padrão ou para tarefas de versões anteriores. |
| 1305   | Apenas o plano Studio é permitido.                                                         |
| 1506   | O modelo está expirado.                                                                    |

## Códigos de Erro do Trabalho

| Código | Descrição                           |
| ------ | ----------------------------------- |
| 999    | Falha ao baixar o arquivo.          |
| 20611  | Limite de fluxo de vídeo disparado. |