@youka / cli

Youka REST API的官方命令行客户端。

使用此软件包从您的终端创建卡拉ok视频：上传音频或视频，同步或转录歌词，创建卡拉ok项目，渲染最终视频，并下载MP4。

安装

npm install -g @youka/cli

API密匙

创建一个API密钥 online.youka.io /账户 下 API密钥.

登录一次：

youka login "yk_..."

或者把钥匙放在你的环境中：

export YOUKA_API_KEY="yk_..."

检查哪个帐户、密钥源和API URL是活动的：

youka whoami --json

制作卡拉ok视频

从本地歌曲创建一个项目，同步您的歌词，导出卡拉ok视频，并下载MP4：

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

然后导出完成的项目：

youka export create proj_123 \
  --resolution 1080p \
  --quality high \
  --wait \
  --download \
  --output ./karaoke.mp4 \
  --json

或者在一个命令中完成整个流程：

youka project create ./song.mp3 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --download \
  --output ./karaoke.mp4 \
  --json

自动转录歌词

使用转录时，你还没有歌词文本：

youka project create ./song.mp3 \
  --mode transcribe \
  --download \
  --output ./karaoke.mp4 \
  --json

使用托管媒体URL

youka project create https://example.com/song.mp4 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --download \
  --output ./karaoke.mp4 \
  --json

当需要URL下载和本地渲染时，安装本地helper二进制文件：

youka deps status --json
youka deps ensure --for all --json
youka deps ensure --for render --update --json
youka deps path ffmpeg

文档

• CLI指南: https://docs.youka.io/en/cli
• JavaScript SDK: https://docs.youka.io/en/sdk

发现功能和创建抒情视频

youka capabilities --json
youka project quote ./reference.wav --duration 120 --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --lyrics "Optional recognition hints" --json
youka project create ./reference.wav --kind lyric-video --mode align --sync-model audioshake-alignment --lyrics "Supplied lyrics" --wait --json

--kind lyric-video 跳过分离和拒绝 --split-model。省略了类 保留卡拉ok行为。所有支持的模型都通过工作流和 输入要求;需要独立人声的模型无法处理原声 直接追踪。 --mode transcribe 通过接收识别提示 --lyrics (或 --text 用于 project sync）。 --language-hint-mode auto|explicit 控制 语言政策。Wav2Vec2是一个对齐模型。

时间安排和版本选择

youka project timings list proj_123 --json
youka project timings get proj_123 alignment_123 --json
youka project timings import proj_123 alignment_123 --body corrected-timings.json --json
youka project timings select proj_123 alignment_123 --expected-revision REVISION --expected-selection-revision SELECTION_REVISION --json
youka project versions proj_123 --json
youka project settings proj_123 --version-id version_123 --json
youka export create proj_123 --local --version-id version_123 --transparent --mute-all --fps 30 --output ./overlay.mov --json

corrected-timings.json 包含 { "alignment": { "items": [...] }, "expectedRevision": "...", "select": true, "expectedSelectionRevision": "..." }. 使用 --body - 从stdin中读取JSON对象。计时取代了完整 对齐，使用绝对秒，并保留文本和支持的元数据。 无效的时间间隔和过时的修订失败，而不是被静默修复。 读取结果使用正常的CLI JSON信封；构造从的导入对象 它的 data 字段，而不是把整个信封传回去。

计时编辑和选择不启动AI任务。 --mute-all 所有存在的沉默 茎和优先于音量覆盖；它不承诺消除 音频流。透明的本地导出使用ProRes 4444，不会引发 云导出或对齐费用。现有的功能资格仍然适用。 行预判取决于所选的布局。

在发布更新后的CLI之前，部署匹配的API端点。