Skip to main content
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 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.
Agents devem chamar preset schema antes de alterar predefinições para que conheçam os nomes exatos dos campos e os tipos de valor.

preset list

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

preset show

Busque uma única predefinição por ID.

preset create

Crie uma nova predefinição.

Opções

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

Exemplos

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

preset update

Atualize uma predefinição existente.
Exemplo:

preset delete

Exclua uma predefinição por ID.
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.

preset default

Obtenha ou defina a predefinição padrão.
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:

Próximos passos

  • Render settings reference - todos os campos compartilhados de predefinição
  • Projects - aplique predefinições às configurações do projeto
  • Exports - aplique predefinições no momento da renderização
  • Media - mídia reutilizável referenciada por predefinições