---
title: "Decupagem"
description: "Como o roteiro vira cenas, planos, diálogo, elenco, cenários e objetos de cena, e o que significa aprovar a decupagem."
url: https://www.filmsquare.ai/docs/pt-br/departments/breakdown/
lang: pt-BR
section: departments
updated: 2026-11-07
mcp: [get_script, submit_breakdown, get_episode, request_signoff, sign_off, work_on_step, find_actions, run_action]
---

# Decupagem

A decupagem transforma o roteiro no plano do episódio: cenas, planos na ordem do corte, o diálogo
por plano, e o elenco, os cenários e os objetos de cena de que o episódio precisa. Casting, Figurino, Cenários e Objetos de cena partem dela. Você trabalha
nela em dois lugares: **Script → Tagging** para as marcações no roteiro, **Storyboard → Shot list** para os planos. Os dois
levam a mesma aprovação.

![O departamento de Decupagem de um episódio, com os planos agrupados por cena](https://www.filmsquare.ai/docs/shots/en/board-breakdown-desktop.webp)

## O que esta etapa produz

- **Cenas**, com os seus cabeçalhos de cena (`INT. COZINHA – NOITE`). As cenas são opcionais: um episódio pode ter planos
  direto nele.
- **Planos**, na ordem do corte, com uma descrição, um enquadramento e uma duração.
- **Falas de diálogo**, ligadas ao personagem que as diz.
- **Elementos**: um personagem por personagem do roteiro, um cenário por locação, um objeto de cena por objeto. Cada um ganha um @nome. Veja
  [Elementos, versões e @nomes](https://www.filmsquare.ai/docs/pt-br/concepts/elements/).

**Storyboard → Shot list** mostra os planos agrupados por cena, na ordem do corte.

## Quem trabalha nela

Em uma equipe de cinema, o(a) diretor(a) com um(a) primeiro(a) assistente de direção ou continuísta. São funções de equipe, não funções do Filmsquare: o que
uma pessoa pode fazer vem da sua [função no espaço de trabalho](https://www.filmsquare.ai/docs/pt-br/working-together/crew-and-roles/#the-six-roles). Um(a) produtor(a) pode escalar pessoas para a etapa inteira, ou para uma
só cena ou plano (**Assign crew to** na linha).

## Como a IA prepara

Há dois leitores:

| Leitor | O que você recebe | Custo |
| --- | --- | --- |
| O leitor de Fountain | Cenas, personagens e locações; um plano por cena | Grátis, na hora |
| O seu próprio Claude (`break_down_episode`) | Uma lista de planos com notas de atuação, diálogo por plano, elenco, cenários e objetos de cena, reaproveitando os @nomes que existem | A assinatura do seu próprio Claude |

O leitor de Fountain roda em toda importação de roteiro. Para a lista de planos completa, peça ao seu próprio Claude: ele lê o roteiro
com `get_script`, faz a decupagem e a envia com `submit_breakdown`. O servidor confere com a mesma
validação de uma importação. Reenviar atualiza o que mudou.

> [!NOTE]
> Um servidor com chave própria da Anthropic também oferece **Claude prepares it** no formulário de importação (e **Let Claude
> prepare the breakdown** quando você começa uma produção a partir de um roteiro); essa decupagem roda no servidor e custa
> créditos. O app.filmsquare.ai não tem essa chave, então a opção não aparece lá: use o seu próprio Claude.

Você sempre pode corrigir a decupagem na mão: descreva os planos na lista de planos e no plano, acrescente um com **New shot** (novo plano)
e mude a ordem no [corte](https://www.filmsquare.ai/docs/pt-br/working-together/the-cut/#trim-and-order).

Salvar um roteiro no app não roda um leitor: a decupagem fica como está até você importar o roteiro de novo ou
o seu próprio Claude enviar uma nova.

## Marcações no roteiro

**Script → Tagging** mostra a versão mais nova do roteiro: as cenas à esquerda, o roteiro no papel no meio
e o que está marcado na cena em vista à direita. Uma marcação assinala palavras como **Cast**, **Location**, **Prop** ou
**Costume**, na cor do departamento.

Quando alguém com a função de artista ou acima abre a tela, o Filmsquare marca sozinho os nomes e @nomes de elementos existentes,
de graça e sem IA. O que as pessoas corrigiram fica.

- **Marcar palavras:** selecione-as e escolha um tipo. **All N in the script** (todas as N no roteiro) marca todos os lugares em que as mesmas palavras aparecem.
- **Corrigir uma marcação:** clique na palavra marcada e escolha outro tipo, ou **Remove** (remover).
- **Fazer o elemento:** na lista à direita, **Create** (criar) faz o personagem, cenário ou objeto de cena de uma marcação que ainda não tem
  um. Um elemento marcado mostra o seu @nome.

As marcações passam para uma nova versão do roteiro; as palavras que sumiram saem.

## A lista de planos

**Storyboard → Shot list** é uma tabela dos planos, com o tempo corrido por cena. Um(a) diretor(a) ou alguém acima edita
**Description**, **Size**, **Lens**, **Move** e **Length** na célula: as setas passam entre as células, Enter ou
digitar abre uma. **In frame** mostra os elementos no plano, e o código de um plano abre o plano.

## Aprovar

Aprovar a Decupagem diz: estes são os planos, o elenco, os cenários e os objetos de cena que vamos fazer. Ela não segura
os finais por padrão. Casting, Figurino, Cenários e Objetos de cena dependem dela. A aprovação fica no alto de **Script →
Tagging** e de **Storyboard → Shot list**: a lista de planos é aprovada com o quadrado da Decupagem.

## O que a deixa desatualizada

A Decupagem depende do Roteiro. Um novo tratamento do roteiro a deixa **Changed after sign-off** (alterado após aprovação) ("O roteiro mudou depois
da aprovação"), e a mudança segue para todo departamento depois dela.

## Quanto custa

Nada em créditos: o leitor de Fountain é grátis, e o seu próprio Claude roda na sua própria assinatura.

## Com o seu próprio Claude

As ferramentas estão em Com o Claude nesta página. Mudanças avulsas, como criar ou mover um plano, passam por
`find_actions` e `run_action`, e as marcações também (`listScriptTags`, `createScriptTag`); o Claude pergunta a você antes de
pedir a aprovação do Roteiro.
