> ## 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.

# Youka 文档

> 使用 Youka Web 应用、桌面应用、CLI、API 和 SDK 创建卡拉 OK 的指南与参考

Youka 可以把任何歌曲变成卡拉 OK 视频。本网站涵盖所有使用方式——在 Web 应用或桌面应用中点选操作、通过命令行自动化处理，或通过 API 与 SDK 嵌入到你自己的产品中。

## 什么是 Youka？

Youka 会从任意音频文件或 URL 中分离人声，逐词同步歌词，并渲染出可编辑、可导出、可分享的成品卡拉 OK 视频。同一套处理流程可在浏览器、桌面端以及公共 API 中使用。

## 我应该使用哪个？

<Columns cols={2}>
  <Card title="Web App" icon="globe" href="/zh/web">
    在浏览器中创建并编辑卡拉 OK。最适合快速一次性制作、
    基于浏览器的工作流，以及 Studio 编辑器。
  </Card>

  <Card title="Desktop App" icon="display" href="/zh/desktop">
    在电脑上安装 Youka。最适合从文件或
    URL 创建卡拉 OK、使用键盘快捷键编辑，以及本地导出 MP4。
  </Card>

  <Card title="CLI" icon="terminal" href="/zh/cli">
    通过脚本自动化完整流程。最适合批量任务与本地
    渲染工作流。
  </Card>

  <Card title="SDK" icon="code" href="/zh/sdk">
    从 Node.js 或 Bun 调用 Youka。最适合把卡拉 OK 功能集成到你的
    产品中。
  </Card>

  <Card title="API" icon="server" href="/zh/api">
    从任何语言调用公共 REST API。最适合服务到服务的
    集成。
  </Card>

  <Card title="AI Agents" icon="robot" href="/zh/agents">
    用于让智能体自动驱动 Youka 的
    操作规则与工作流模式。
  </Card>
</Columns>

## 刚开始使用 Youka？

<Steps>
  <Step title="选择你的使用入口">
    大多数首次使用的用户会从 [web app](/zh/web/create-karaoke) 开始。如果
    你想要本地安装的工作流，从 [desktop
    app](/zh/desktop/youtube-to-karaoke) 开始。开发者通常从
    [CLI](/zh/cli) 开始。
  </Step>

  <Step title="创建你的第一个卡拉 OK">
    上传文件或粘贴 URL。Youka 会分离音轨、同步歌词，并
    渲染预览。
  </Step>

  <Step title="自定义外观">
    选择背景、调整字幕样式，并裁剪歌曲。
  </Step>

  <Step title="导出">
    下载成品视频或分享播放链接。
  </Step>
</Steps>

## 热门指南

* [创建你的第一个卡拉 OK（Web）](/zh/web/create-karaoke) — 上传歌曲，几分钟内完成导出
* [使用 Studio 编辑器](/zh/web/using-studio) — 在浏览器中编辑歌词、时间轴、布局与样式
* [视频 URL 转卡拉 OK](/zh/desktop/youtube-to-karaoke) — 将任意在线视频变成卡拉 OK 音轨
* [修复歌词同步](/zh/desktop/fix-lyrics-sync) — 时间对不齐时的解决方案
* [CLI 快速入门](/zh/cli) — 在终端中自动化完整流程
* [SDK 快速入门](/zh/sdk/quickstart) — 用几行代码从 Node.js 创建项目