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

# Roteiros e Edição

> As ferramentas dos roteiros, das peças e do motor de vídeo do estúdio.

Na coluna **Como**: *lista* é a que a IA vê e chama direto; *programa* é alcançada por `studio_run`; *direta* gasta crédito ou pede o seu aceite a cada vez: a IA só chama quando você decide, e nunca de um programa.

## Roteiros

| Ferramenta | O que faz | Como |
| - | - | - |
| `scripts` | Os roteiros da marca, com formato, versão e se estão em revisão ou aprovados. | programa |
| `script` | Um roteiro inteiro, na versão mais nova: cada parte, o que é dito e o que aparece na tela. | programa |
| `captions` | As legendas das peças aprovadas, marcando as que você mesmo escreveu, que são o jeito da marca. | programa |
| `script_show` | Mostra na conversa um roteiro, ou até seis escritos juntos num cartão só, para você aprovar ou pedir ajuste em palavras suas. | lista |
| `script_approve` | Aprova a versão mais nova de um roteiro, quando você diz que aprova ou aperta Aprovar num app que não levou o clique. | direta |

Aprovar um roteiro é decisão sua. A IA aprova com `script_approve` só quando você diz, na conversa ou na tela.

## Edição

| Ferramenta | O que faz | Como |
| - | - | - |
| `edits` | As peças da marca a caminho da edição: os roteiros aprovados e as peças pedidas sem roteiro, com o id da edição mais nova e o da aprovada. | programa |
| `piece_look` | Mostra à IA uma peça pronta, para ela mesma ver: cada imagem de um carrossel ou post, um vídeo pela capa, com a legenda e o link de cada arquivo. | lista |
| `piece_new` | Cria uma peça direto na Edição, sem ideia e sem roteiro, quando você pede uma peça. | lista |
| `edit_upload` | Abre o envio da peça pronta: a peça, o pacote do projeto e o que é dito nela, num envio só. | programa |
| `edit_show` | Mostra na conversa a peça entregue, ou até seis entregues juntas num cartão só (três artes de uma campanha, por exemplo), para você assistir e aprovar ou pedir ajuste em cada uma. | lista |
| `piece_approve` | Aprova a edição mais nova de uma peça: ela vai para Prontas para postar, com a legenda. | direta |
| `piece_adjust` | Monta o pedido de ajuste de uma peça com as suas palavras, guardando tudo que a edição anterior tinha (o jeito na tela, quem aparece, a referência, os arquivos, a música). A IA começa o ajuste com `edit_start` e esse pedido. | direta |
| `piece_publish` | Posta peças prontas no seu perfil, com a legenda escolhida e quem pode usar como modelo, como o Postar da Edição. | direta |
| `piece_recipe` | Como uma peça publicada foi feita, quando quem publicou deixa ver. | programa |
| `template_from_post` | Faz um modelo de edição a partir de um post do Radar. | programa |

Aprovar, pedir ajuste e postar são decisão sua. A IA faz quando você diz ("aprovado", "deixa o logo maior", "pode postar") ou quando uma tela avisa que você apertou o botão num app que não levou o clique. Uma peça só vai para o perfil com o descritivo do modelo escrito. Se ela tem mais de uma legenda, a IA pergunta qual vai.

## Motor de vídeo

O estúdio tem o próprio motor (HyperFrames) para o que ele prepara do lado dele: uma referência lida, um trecho de vídeo, os motions da marca. Cada estúdio tem os seus projetos, e nenhum caminho sai do projeto.

| Ferramenta | O que faz | Como |
| - | - | - |
| `video_files` | Os arquivos de um projeto de vídeo, com o tamanho. | programa |
| `video_read` | Lê um arquivo de texto do projeto: a composição, os estilos, os scripts. | lista |
| `video_write` | Escreve um arquivo de texto inteiro no projeto. | lista |
| `video_delete` | Apaga um arquivo do projeto. | programa |
| `video_fetch` | Baixa um arquivo da web para o projeto. | programa |
| `video_brand` | Traz a identidade da marca para o projeto: o logo e as fontes. | programa |
| `video_motions` | Os motions prontos da marca, como telas do produto se mexendo. | programa |
| `video_motion_bring` | Copia um motion da marca para o projeto, com tudo o que ele usa. | programa |
| `video_motion_keep` | Guarda na Biblioteca um motion feito numa peça, para usar de novo. | programa |
| `video_kit_bring` | Copia o kit de um plugin ligado para o projeto. | programa |
| `video_run` | Roda um comando do HyperFrames no projeto, de uma lista permitida. | programa |
| `video_look` | Mostra uma imagem do projeto: um arquivo, ou um vídeo num instante. | lista |
| `video_reference` | Prepara um post de referência no projeto, na fila do estúdio. | programa |
| `video_clip` | Traz um trecho de um vídeo do YouTube para o projeto, na fila do estúdio. | programa |
| `video_render` | Renderiza o projeto em MP4, na fila do estúdio. | programa |
| `video_status` | Em que pé está uma renderização ou uma referência. | programa |

As tarefas desta área são o roteiro, a revisão, a legenda, a edição, o modelo e o descritivo do modelo. Veja [Tarefas](https://docs.unbrella.com.br/ferramentas/tarefas.md).


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