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.
youka preset schema --json
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.
youka preset list --json

preset show

Busque uma única predefinição por ID.
youka preset show <presetId> --json

preset create

Crie uma nova predefinição.
youka preset create [options]

Opções

OpçãoDescrição
--name <name>Nome da predefinição
--defaultMarcar a nova predefinição como padrão
--body <file|->Ler o corpo completo da requisição de um arquivo ou stdin
O corpo da requisição deve conter o objeto preset completo. Para payloads grandes, prefira --body em vez de JSON inline.

Exemplos

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json
As flags da CLI substituem os campos correspondentes de --body.

preset update

Atualize uma predefinição existente.
youka preset update <presetId> [options]
OpçãoDescrição
--name <name>Novo nome
--body <file|->Corpo completo da requisição de um arquivo ou stdin
Exemplo:
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

preset delete

Exclua uma predefinição por ID.
youka preset delete <presetId> --json
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.
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:
youka project create ./song.mp3 --preset $PRESET_ID --wait

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