Agentes de IA

Use Youka to create a karaoke video from /path/to/song.mp3. Transcribe the lyrics in English, use a clean karaoke subtitle style, export the final video in 1080p, and save it as ./karaoke.mp4.

Use Youka to create a karaoke video from https://example.com/song.mp4. If URL dependencies are missing, install them first. Then transcribe the lyrics automatically, use a clean karaoke subtitle style, export the final video, and save it as ./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/pt/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/pt/sdk";

const presetSchema = KaraokePresetSchema.toJSONSchema();