Skip to main content
यह गाइड @youka/sdk का उपयोग करके एक कच्ची ऑडियो फ़ाइल से रेंडर किए गए कराओके वीडियो तक पहुँचने का सबसे तेज़ रास्ता बताती है।

शुरू करने से पहले

  • Node.js 20 या बाद का संस्करण
  • YOUKA_API_KEY में एक Youka API key ( API keys के तहत online.youka.io/account पर जाकर एक बनाएं)
  • एक लोकल ऑडियो फ़ाइल (./song.mp3) या एक रिमोट URL

इंस्टॉल

npm install @youka/sdk

बनाएं, इंतज़ार करें, एक्सपोर्ट करें

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

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

async function main() {
  // 1. एक लोकल फ़ाइल से प्रोजेक्ट बनाएं
  const projectOperation = await client.projects.create({
    source: { type: "path", path: "./song.mp3" },
    lyricsSource: { type: "transcribe" },
  });

  // 2. stems और lyrics sync के पूरा होने का इंतज़ार करें
  const { project } = await client.projects.wait(projectOperation);
  console.log("Project ready:", project.id, project.title);

  // 3. एक एक्सपोर्ट शुरू करें
  const exportOperation = await client.exports.create(project.id, {
    resolution: "1080p",
    quality: "high",
  });

  // 4. एक्सपोर्ट के पूरा होने का इंतज़ार करें
  const finishedExport = await client.exports.wait(exportOperation);
  await client.exports.download(finishedExport, {
    output: "./exports",
  });
  console.log("Export ready:", finishedExport.url);
}

main().catch((error) => {
  if (error instanceof YoukaRequestError) {
    console.error("Request failed:", error.code, error.status, error.message);
    process.exit(1);
  }
  if (error instanceof YoukaTaskError) {
    console.error("Task failed:", error.code, error.status, error.message);
    process.exit(1);
  }
  throw error;
});
client.projects.create() path, bytes, और url sources के लिए uploads संभालता है। लो-लेवल upload नियंत्रण के लिए, client.uploads.* का उपयोग करें।

तीन source types

const operation = await client.projects.create({
  source: { type: "path", path: "./song.mp3" },
});

आगे क्या

  • Projects — पूर्ण projects API
  • Exports — लोकल render और client.exports.prepareLocal
  • ErrorsYoukaRequestError और YoukaTaskError को संभालें
  • AI agents — अनुशंसित polling और retry पैटर्न