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

# Predefinições

> Gerencie configurações de renderização reutilizáveis

Uma predefinição é uma configuração de renderização reutilizável — fundo, estilo de legendas, layout e outras definições visuais — que você pode aplicar a qualquer projeto ou exportação. Predefinições são ideais quando você mantém um visual consistente em várias faixas.

Veja [Render settings reference](/en/render-settings-reference) para o formato completo de
`preset` e todas as opções baseadas em enum.

## `preset schema`

Retorna o JSON Schema para as configurações de predefinição. Use isso para descobrir campos válidos antes de criar ou atualizar uma predefinição.

```bash theme={null}
youka preset schema --json
```

<Tip>
  Agents devem chamar `preset schema` antes de alterar predefinições para que conheçam os
  nomes exatos dos campos e os tipos de valor.
</Tip>

## `preset list`

Liste todas as predefinições pertencentes à conta autenticada.

```bash theme={null}
youka preset list --json
```

## `preset show`

Busque uma única predefinição por ID.

```bash theme={null}
youka preset show <presetId> --json
```

## `preset create`

Crie uma nova predefinição.

```bash theme={null}
youka preset create [options]
```

### Opções

| Opção              | Descrição                                                 |
| ------------------ | --------------------------------------------------------- |
| `--name <name>`    | Nome da predefinição                                      |
| `--default`        | Marcar a nova predefinição como padrão                    |
| `--body <file\|->` | Ler o corpo completo da requisição de um arquivo ou stdin |

<Note>
  O corpo da requisição deve conter o objeto `preset` completo. Para payloads grandes,
  prefira `--body` em vez de JSON inline.
</Note>

### Exemplos

<CodeGroup>
  ```bash from-file theme={null}
  youka preset create \
    --name "Neon Night" \
    --body ./neon-preset.json \
    --json
  ```

  ```bash make-default theme={null}
  youka preset create \
    --name "Red Cinema" \
    --body ./red-cinema.json \
    --default \
    --json
  ```

  ```bash from-stdin theme={null}
  cat ./preset.json | youka preset create --name "From stdin" --body - --json
  ```
</CodeGroup>

As flags da CLI substituem os campos correspondentes de `--body`.

## `preset update`

Atualize uma predefinição existente.

```bash theme={null}
youka preset update <presetId> [options]
```

| Opção              | Descrição                                           |
| ------------------ | --------------------------------------------------- |
| `--name <name>`    | Novo nome                                           |
| `--body <file\|->` | Corpo completo da requisição de um arquivo ou stdin |

Exemplo:

```bash theme={null}
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json
```

## `preset delete`

Exclua uma predefinição por ID.

```bash theme={null}
youka preset delete <presetId> --json
```

<Warning>
  Excluir uma predefinição não exclui projetos nem exportações que foram
  renderizados anteriormente com ela. Exportações futuras que referenciem a
  predefinição excluída falharão.
</Warning>

## `preset default`

Obtenha ou defina a predefinição padrão.

```bash theme={null}
youka preset default --json
youka preset default <presetId> --json
```

Sem argumento, o comando retorna a predefinição padrão atual ou `null`. Com um ID de predefinição, ele marca essa predefinição como padrão.

## Aplicando uma predefinição

Aplique uma predefinição a um projeto ou exportação com `--preset`:

<CodeGroup>
  ```bash on-create theme={null}
  youka project create ./song.mp3 --preset $PRESET_ID --wait
  ```

  ```bash on-settings-update theme={null}
  youka project settings $PROJECT_ID --preset $PRESET_ID
  ```

  ```bash on-export theme={null}
  youka export create $PROJECT_ID --preset $PRESET_ID --wait
  ```
</CodeGroup>

## Próximos passos

* [Render settings reference](/en/render-settings-reference) - todos os campos compartilhados de predefinição
* [Projects](/pt/cli/projects) - aplique predefinições às configurações do projeto
* [Exports](/pt/cli/exports) - aplique predefinições no momento da renderização
* [Media](/pt/cli/media) - mídia reutilizável referenciada por predefinições