Skip to main content

Quickstart

Get up and running in under 5 minutes.

1. Install​

npm install @decrackle/sdk

2. Create the client​

import { Decrackle } from '@decrackle/sdk';

const client = new Decrackle({
  apiKey: process.env.DECRACKLE_API_KEY,
});

3. Transcribe audio​

import { readFileSync } from 'fs';

const audio = readFileSync('./interview.wav');

const result = await client.asr.transcribe(audio, {
  language: 'en',
});

console.log(result.transcriptionText);
// → "Hello, welcome to the meeting..."

console.log(`Detected language: ${result.detectedLanguage}`);
console.log(`Processing time: ${result.processingTimeMs}ms`);

4. Denoise audio​

const noisy = readFileSync('./noisy-recording.wav');

const result = await client.denoise.process(noisy);

console.log('Clean audio URL:', result.outputUrl);
console.log(`Processing time: ${result.processingTimeMs}ms`);

5. Handle errors​

import { Decrackle, DecrackleAuthError, DecrackleValidationError } from '@decrackle/sdk';

try {
  const result = await client.asr.transcribe(audioBuffer);
} catch (err) {
  if (err instanceof DecrackleAuthError) {
    console.error('Invalid API key');
  } else if (err instanceof DecrackleValidationError) {
    console.error('Bad request:', err.message, err.code);
  } else {
    throw err;
  }
}

Next steps​