Skip to main content
本指南将带你以最快路径使用 @youka/sdk 将原始音频文件生成渲染好的卡拉OK视频。

开始之前

  • Node.js 20 或更高版本
  • YOUKA_API_KEY 中设置 Youka API key(在 online.youka.io/accountAPI keys 下创建)
  • 本地音频文件(./song.mp3)或远程 URL

安装

创建、等待、导出

client.projects.create() 会为 pathbytesurl 类型的 source 处理上传。若需要更底层的上传控制,请使用 client.uploads.*

三种 source 类型

接下来

  • Projects — 完整的 projects API
  • Exports — 本地渲染与 client.exports.prepareLocal
  • Errors — 处理 YoukaRequestErrorYoukaTaskError
  • AI agents — 推荐的轮询与重试模式