Node.js SDK

import { Resemble } from "@resemble/node";
Resemble.setApiKey(process.env.RESEMBLE_API_KEY!);

const page = 1;
const pageSize = 10;
const response = await Resemble.v2.projects.all(page, pageSize);
const projects = response.items;

await Resemble.v2.projects.get(projectUuid);

await Resemble.v2.projects.create({
  name: "Cooking Podcast",
  description: "Clips generated for our Thursday night cooking podcast",
  is_collaborative: true,
  is_archived: false
});

await Resemble.v2.projects.update(projectUuid, {
  name: "Friday Night Cooking Podcast",
  description: "Clips generated for the podcast",
  is_collaborative: true,
  is_archived: false
});

await Resemble.v2.projects.delete(projectUuid);

const page = 1;
const pageSize = 10;
const response = await Resemble.v2.voices.all(page, pageSize);
const voices = response.items;

await Resemble.v2.voices.get(voiceUuid);

await Resemble.v2.voices.create({
  name: "Chef",
  dataset_url: "https://example.com/dataset.zip",
  callback_uri: "http://example.com/cb",
  language: "en-US"
});

await Resemble.v2.voices.build(voiceUuid);

await Resemble.v2.voices.delete(voiceUuid);

const voiceUuid = '...';
const page = 1;
const pageSize = 10;
const response = await Resemble.v2.recordings.all(voiceUuid, page, pageSize);
const recordings = response.items;

await Resemble.v2.recordings.get(voiceUuid, recordingUuid);

const fs = require('fs');
const file = fs.createReadStream('happy_sample.wav');
const fileSize = fs.statSync('happy_sample.wav').size;
await Resemble.v2.recordings.create(voiceUuid, {
  emotion: 'happy',
  is_active: true,
  name: 'happy_sample',
  text: 'Hey, this is a happy sample!'
}, file, fileSize);

await Resemble.v2.recordings.update(voiceUuid, recordingUuid, {
  emotion: 'happy',
  is_active: false,
  name: 'happy_sample',
  text: 'Hey, this is a happy sample!'
});

await Resemble.v2.recordings.delete(voiceUuid, recordingUuid);

const projectUuid = '...';
const page = 1;
const pageSize = 10;
const response = await Resemble.v2.clips.all(projectUuid, page, pageSize);
const clips = response.items;

await Resemble.v2.clips.get(projectUuid, clipUuid);

const response = await Resemble.v2.clips.createSync(projectUuid, {
  title: "Welcome",
  voice_uuid: voiceUuid,
  body: "Welcome to our show",
  is_archived: false
});
if (response.success) {
  const clip = response.item;
  console.log(clip.audio_src);
}

Resemble.setSynthesisUrl('https://f.cluster.resemble.ai');
const response = await Resemble.v2.clips.createDirect({
  voice_uuid: voiceUuid,
  project_uuid: projectUuid,
  title: 'My Clip',
  data: 'Hello, how are you?',
  precision: 'PCM_32',
  output_format: 'wav',
  sample_rate: 48000
});

// Configure synthesis URL for streaming
Resemble.setApiKey('YOUR_API_TOKEN');
Resemble.setSynthesisUrl('YOUR_SYNTH_ENDPOINT');
for await (const chunk of Resemble.v2.clips.stream({
  data: 'This is a streaming test',
  project_uuid: projectUuid,
  voice_uuid: voiceUuid
})) {
  // Process audio chunk (Buffer)
  console.log('Received chunk:', chunk.length);
}

stream: async function* (
  streamInput: {
    data: string
    project_uuid: string
    voice_uuid: string
    sample_rate?: 8000 | 16000 | 22050 | 44100 | 32000
    precision?: 'MULAW' | 'PCM_16' | 'PCM_24' | 'PCM_32'
  },
  streamConfig?: {
    bufferSize?: number       // Default: 4096
    ignoreWavHeader?: boolean // Default: false
    getTimeStamps?: boolean   // Default: false
  }
): AsyncGenerator

await Resemble.v2.clips.updateAsync(projectUuid, clipUuid, {
  voice_uuid: voiceUuid,
  body: 'This is an updated async test',
  callback_uri: 'https://example.com/callback/resemble-clip',
  title: 'Updated Title',
  sample_rate: 48000
});

await Resemble.v2.clips.delete(projectUuid, clipUuid);

const page = 1;
const pageSize = 10;
const response = await Resemble.v2.termSubstitutions.all(page, pageSize);
const substitutions = response.items;

const tsUuid = '...';
const response = await Resemble.v2.termSubstitutions.get(tsUuid);
const substitution = response.item;

const response = await Resemble.v2.termSubstitutions.create('Original', 'Replacement');
const substitution = response.item;

const substitutionUuid = '...';
await Resemble.v2.termSubstitutions.delete(substitutionUuid);

const callbackUrl = 'https://example.com/webhooks/detect';
const response = await Resemble.v2.detection.create({
  url: 'https://storage.googleapis.com/resemble-ai-docs-public-files/sts-donor-example.wav',
  callback_url: callbackUrl,
  visualize: true,
  frame_length: 4,
  start_region: 0,
  end_region: 10,
  intelligence: true,
  audio_source_tracing: true,
  use_ood_detector: true
});
// Full API response
console.log(JSON.stringify(response, null, 2));
// Parsed values
const result = response.item;
const detectionUuid = response.item?.uuid;
const status = response.item?.status;

const callbackUrl = 'https://example.com/webhooks/detect';
const response = await Resemble.v2.detection.detectAndGet({
  url: 'https://storage.googleapis.com/resemble-ai-docs-public-files/sts-donor-example.wav',
  callback_url: callbackUrl,
  visualize: true,
  frame_length: 1,
  start_region: 0,
  end_region: 10,
  intelligence: true,
  audio_source_tracing: true,
  use_ood_detector: true
});
// Full API response
console.log(JSON.stringify(response, null, 2));
// Parsed values
const result = response.item;
const status = response.item?.status;

import fs from 'fs';
import path from 'path';
const callbackUrl = 'https://example.com/webhooks/detect';
const filePath = path.resolve('path/to/local-audio.wav');
if (!fs.existsSync(filePath)) {
  throw new Error(`File not found: ${filePath}`);
}
const response = await Resemble.v2.detection.detectAndGet(
  {
    file: filePath,
    callback_url: callbackUrl,
    visualize: true,
    frame_length: 4,
    start_region: 0,
    end_region: 10,
    intelligence: true,
    audio_source_tracing: true,
    use_ood_detector: true
  },
  10, // maxAttempts
  3   // waitTimeSeconds
);
// Full API response
console.log(JSON.stringify(response, null, 2));
// Parsed values
const result = response.item;
const status = response.item?.status;