AI 代理

使用 Youka 从 /path/to/song.mp3 创建一个卡拉 OK 视频。将歌词转录为英文，使用干净的卡拉 OK 字幕风格，导出最终视频为 1080p，并保存为 ./karaoke.mp4。

使用 Youka 从 https://example.com/song.mp4 创建一个卡拉 OK 视频。如果缺少 URL 依赖项，先安装它们。然后自动转录歌词，使用干净的卡拉 OK 字幕风格，导出最终视频，并保存为 ./karaoke.mp4。

# 1. Create the project and wait for stems + lyrics sync to finish
PROJECT_JSON=$(youka project create ./song.mp3 \
  --mode transcribe \
  --lang en \
  --wait \
  --idempotency-key "create-song-2026-04-08-001" \
  --json)

PROJECT_ID=$(echo "$PROJECT_JSON" | jq -r '.data.projectId')

# 2. Start and wait for an export
EXPORT_JSON=$(youka export create "$PROJECT_ID" \
  --resolution 1080p \
  --quality high \
  --wait \
  --download \
  --output ./karaoke.mp4 \
  --idempotency-key "export-$PROJECT_ID-v1" \
  --json)

echo "Done:" "$(echo "$EXPORT_JSON" | jq -r '.data.fileUrl')"

import { YoukaClient, YoukaRequestError, YoukaTaskError } from "@youka/zh/sdk";

const client = new YoukaClient({ apiKey: process.env.YOUKA_API_KEY! });

async function createAndExport() {
  // 1. Create the project and wait for stems + lyrics sync
  const created = await client.projects.create(
    {
      source: { type: "path", path: "./song.mp3" },
      lyricsSource: { type: "transcribe", language: "en" },
    },
    { idempotencyKey: "create-song-2026-04-08-001" },
  );

  const { project } = await client.projects.wait(created);

  // 2. Start and wait for an export
  const exportResult = await client.exports.create(
    project.id,
    { resolution: "1080p", quality: "high" },
    { idempotencyKey: `export-${project.id}-v1` },
  );

  const finalized = await client.exports.wait(exportResult);

  // 3. Download the file
  await client.exports.download(finalized, {
    output: "./karaoke.mp4",
  });
}

createAndExport().catch((error) => {
  if (error instanceof YoukaRequestError && error.retryable) {
    // Retry with the same idempotency keys
  }
  if (error instanceof YoukaTaskError) {
    console.error("Task failed:", error.code, error.task.error);
  }
  throw error;
});

# Preset body schema
youka preset schema --json

import { KaraokePresetSchema } from "@youka/zh/sdk";

const presetSchema = KaraokePresetSchema.toJSONSchema();