Projetos

Um projeto armazena a mídia de origem, letras, configurações de renderização e exportações para um karaokê ou vídeo com letra. Projetos de karaokê também contêm stems separados.

`project create`

Crie um novo projeto a partir de um arquivo local ou de uma URL.

youka project create <source> [options]

string

required

Um caminho de arquivo local (./song.mp3) ou uma URL HTTP/HTTPS (https://example.com/song.mp4).

Opções

Opção	Descrição
`--kind <kind>`	`karaoke` ou `lyric-video`. O padrão é `karaoke`.
`--title <title>`	Título do projeto
`--mode <mode>`	`none`, `transcribe` ou `align`
`--lyrics <text>`	Texto da letra
`--lang <code>`	Código do idioma
`--sync-model <model>`	Modelo de sincronização de letras
`--split-model <model>`	Modelo de separação de stems
`--max-video-quality <quality>`	Qualidade máxima de vídeo para fontes por URL: `720p`, `1080p`, `4k` ou `best`
`--preset <presetId>`	Aplicar um preset ao criar o projeto
`--export`	Criar uma exportação depois que o projeto estiver pronto
`--download`	Criar uma exportação, aguardar e fazer o download
`--output <path>`	Caminho de saída para `--download`

Exemplos

youka project create ./song.mp3 \
  --title "My Song" \
  --mode transcribe \
  --lang en \
  --wait \
  --json

youka project create "https://example.com/song.mp4" \
  --max-video-quality 4k \
  --download \
  --output ./karaoke.mp4 \
  --json

youka project create ./song.mp3 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --sync-model audioshake-alignment \
  --wait \
  --json

Regras:

Se você passar letras e omitir --mode, a CLI assume align por padrão
align requer letras
transcribe aceita letras de referência opcionais. O modelo pode retornar um texto diferente.
none não aceita letras
--kind lyric-video usa o áudio original sem separação de stems e rejeita --split-model. Omitir --kind preserva o comportamento de karaokê.
--download implica --export
--max-video-quality aplica-se apenas a fontes por URL HTTP/HTTPS. O padrão é 1080p, usa a melhor qualidade disponível até esse limite e recorre ao melhor formato disponível quando a plataforma não expõe um stream limitado.

`project list`

Liste todos os projetos da conta autenticada.

youka project list
youka project list --json

`project quote`

Cote os créditos necessários para criar um projeto sem criar o projeto.

youka project quote <source> [options]

source aceita as mesmas formas de caminho de arquivo local ou URL HTTP/HTTPS de project create. Sem --duration, a CLI faz o upload da origem para que o servidor possa medir a mídia com precisão, mas não cria um projeto.

Opções

Opção	Descrição
`--kind <kind>`	`karaoke` ou `lyric-video`. O padrão é `karaoke`.
`--title <title>`	Título do projeto
`--mode <mode>`	`none`, `transcribe` ou `align`
`--lyrics <text>`	Texto obrigatório para `align`, orientação opcional para `transcribe`
`--lang <code>`	Código do idioma
`--sync-model <model>`	Modelo de sincronização de letras
`--split-model <model>`	Modelo de separação de stems
`--max-video-quality <quality>`	Qualidade máxima de vídeo para fontes por URL: `720p`, `1080p`, `4k` ou `best`
`--duration <seconds>`	Cotar a partir de uma duração conhecida sem fazer upload da origem

Exemplos:

youka project quote ./song.mp3 --mode transcribe --json
youka project quote https://example.com/song.mp4 --max-video-quality 4k --mode transcribe --json
youka project quote ./song.mp3 --duration 210 --mode none --json

`project show`

Obtenha o estado atual do projeto, incluindo state normalizado, pendingOperation, stems, configurações e exportações.

youka project show <projectId>

string

required

O ID do projeto retornado por project create.

`project wait`

Faça polling em um projeto até que ele atinja um estado terminal.

youka project wait <projectId> --json

`project delete`

Exclua um projeto e todos os stems, letras e exportações associados.

youka project delete <projectId> --idempotency-key delete-<projectId>

A exclusão é permanente. Passe --idempotency-key para tornar as tentativas seguras.

`project sync`

Execute novamente a transcrição ou o alinhamento de letras em um projeto existente.

youka project sync <projectId> [options]

Opção	Descrição
`--mode <mode>`	`transcribe` ou `align`
`--text <text>`	Texto da letra
`--lang <code>`	Código do idioma
`--sync-model <model>`	Modelo de sincronização de letras

Exemplo:

youka project sync $PROJECT_ID \
  --mode align \
  --text "$(cat lyrics.txt)" \
  --wait \
  --json

`project separate`

Execute novamente a separação de stems em um projeto existente.

youka project separate <projectId> [--split-model <model>]

Exemplo:

youka project separate $PROJECT_ID --split-model audioshakeai --wait --json

`project settings`

Leia ou atualize as configurações ativas do projeto.

youka project settings <projectId>
youka project settings <projectId> --preset <presetId> --body ./settings.json

Se nem --preset nem --body estiverem presentes, o comando retorna as configurações atuais. Se qualquer um estiver presente, ele executa uma atualização. Exemplos:

youka project settings $PROJECT_ID --json

youka project settings $PROJECT_ID \
  --preset preset_abc123 \
  --body ./project-settings.json \
  --json

`project stem list`

Liste os stems de um projeto.

youka project stem list <projectId>
youka project stem list <projectId> --json

`project stem download`

Baixe um ou mais arquivos de stem para o disco. Os stems são baixados no formato original armazenado; a CLI não os transcodifica.

youka project stem download <projectId> <stemId> --output ./stems
youka project stem download <projectId> --type instrumental --output ./stems
youka project stem download <projectId> --type original --type backing-vocals --type vocals --output ./stems
youka project stem download <projectId> --all --output ./stems

Os valores compatíveis de --type são original, instrumental, vocals e backing_vocals. A CLI também aceita backing-vocals, backingVocals e backingvocals como aliases.

O que vem a seguir

Exports - renderize o karaokê finalizado
Presets - gerencie configurações de renderização reutilizáveis
Render settings reference - campos compartilhados de presets e configurações

Capacidades, versões e tempos

youka capabilities --json retorna IDs de modelos, fluxos de trabalho compatíveis, manipulação de texto, suporte a idiomas e elegibilidade da conta. Wav2Vec2 é um modelo de alinhamento. ElevenLabs Scribe é um modelo de transcrição. Modelos que exigem vocais isolados precisam de um fluxo de trabalho de karaokê com um modelo de separação que produza vocais.

youka capabilities --json
youka project create ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project quote ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project versions proj_example --json
youka project settings proj_example --version-id ver_example --json
youka project timings list proj_example --json
youka project timings get proj_example aln_example --json
youka project timings import proj_example aln_example --body corrected-request.json --json
youka project timings select proj_example aln_example --expected-revision "$ALIGNMENT_REVISION" --expected-selection-revision "$SELECTION_REVISION" --json

project settings --version-id lê ou atualiza a versão escolhida. Omitir a flag usa a versão principal. Importações de timing substituem o alinhamento completo sem um job de processamento ou retenção de créditos. O corpo JSON contém alignment e expectedRevision. O salvamento e seleção atômicos também precisam de select: true e expectedSelectionRevision. Um token desatualizado retorna HTTP 409. Busque e compare os valores atuais antes de tentar outra edição. Veja Automate lyric videos para arquivos de requisição, validação de timing e processamento de catálogo com retomada.

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

Opções

Exemplos

`project list`

`project quote`

Opções

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

O que vem a seguir

Capacidades, versões e tempos

​project create

​Opções

​Exemplos

​project list

​project quote

​Opções

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​O que vem a seguir

​Capacidades, versões e tempos

`project create`

Opções

Exemplos

`project list`

`project quote`

Opções

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

O que vem a seguir

Capacidades, versões e tempos