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

> Publicar vídeos concluídos da API do Vozo no YouTube

A API de Exportação do YouTube publica uma tarefa de vídeo concluída do Vozo em um canal do YouTube conectado. Você pode publicar vídeos de Tradução e Dublagem, Tradução Visual ou Sincronização Labial. A API retorna um novo **ID da tarefa de exportação**; consulte a tarefa de exportação até que ela esteja `done` ou `failed`.

## Antes de começar

* Conecte e autorize seu canal do YouTube no Vozo. Se a conexão tiver expirado, reautorize-a antes de criar uma exportação.
* Você precisa ter acesso à API do Vozo, a exportação para o YouTube habilitada para sua conta e um plano Studio ou superior.
* A tarefa de origem do Vozo deve pertencer ao mesmo usuário e estar concluída. Seu arquivo de vídeo ainda deve estar disponível.
* A publicação no YouTube está sujeita tanto à cota de exportação de 24 horas da sua conta quanto a uma cota do sistema.
* Use uma chave de API no cabeçalho `Authorization: Bearer <api_key>`.

## Fluxo de trabalho

<Steps>
  <Step title="Obter categorias de vídeo">
    Chame [Listar categorias](/docs/pt/api_reference/endpoints/youtube_export/categories) para obter um `category_id` válido para a região do seu canal conectado. Apenas categorias atribuíveis são retornadas.
  </Step>

  <Step title="Criar uma exportação">
    Chame [Criar tarefa de exportação](/docs/pt/api_reference/endpoints/youtube_export/create) com a tarefa de origem concluída, o título, a categoria e a configuração de privacidade. Guarde o `task_id` retornado: ele identifica a **exportação do YouTube**, não a tarefa original do Vozo.
  </Step>

  <Step title="Consultar a tarefa de exportação">
    Chame [Obter tarefa de exportação](/docs/pt/api_reference/endpoints/youtube_export/get) com o ID da tarefa de exportação. Quando `status` for `done`, use `studio_url` para abrir o vídeo no YouTube Studio. Se for `failed`, verifique `error_code`.
  </Step>
</Steps>

## Tarefas de origem e modos

| `task_type`        | `source_mode` compatível                         | Comportamento                                                                                                                |
| ------------------ | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `translate_dub`    | `initial_output`, `generate_new`, `use_existing` | Publica o vídeo exportado original, renderiza novamente o projeto editável ou reutiliza uma exportação de projeto existente. |
| `visual_translate` | `initial_output`, `generate_new`, `use_existing` | As mesmas opções para um vídeo de Tradução Visual.                                                                           |
| `lip_sync`         | Omitir `source_mode`                             | Sempre publica a saída inicial da tarefa concluída de Sincronização Labial.                                                  |

Para Tradução e Dublagem e Tradução Visual, `source_mode` é obrigatório quando a tarefa de origem tem um projeto editável. Para uma tarefa de origem não editável, omiti-lo seleciona `initial_output`. `generate_new` e `use_existing` exigem o projeto editável associado; `use_existing` também exige um vídeo exportado existente. `initial_output` exige uma saída de vídeo da tarefa de origem.

## Status da exportação

| Status       | Significado                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------- |
| `pending`    | Tarefa de exportação aceita, mas ainda não iniciada.                                        |
| `processing` | A publicação está em andamento.                                                             |
| `done`       | Publicação concluída; `studio_url` fica disponível quando o YouTube retorna um ID de vídeo. |
| `failed`     | A publicação falhou; `error_code` está presente quando um motivo da falha está disponível.  |

<Note>
  Esses endpoints não criam nem autorizam uma conexão com o YouTube. Conclua essa configuração no Vozo antes de usar a API de exportação.
</Note>

## Erros comuns da API

| Código | Significado                                                  |
| ------ | ------------------------------------------------------------ |
| `1300` | A tarefa de origem ou de exportação não foi encontrada.      |
| `1601` | A conta do YouTube não está conectada.                       |
| `1602` | A exportação para o YouTube está desativada para esta conta. |
| `1603` | A cota de exportação para o YouTube da conta foi esgotada.   |
| `1604` | A cota do sistema para o YouTube foi esgotada.               |
| `1605` | A conexão com o YouTube requer reautorização.                |
| `1710` | O plano atual não atende ao requisito do plano Studio.       |

Para outras falhas, inspecione os campos `code`, `message` e `errors` opcionais da resposta. Uma tarefa de publicação também pode chegar a `failed` após ter sido criada; consulte seu `error_code` para esse resultado.