Dialogue Separation - AudioShake Developers

Create a Task

Isolate dialogue from the music and effects bed in any audio or video content. Use the separated outputs for dubbing prep, podcast cleanup, broadcast post-production, or feeding clean speech into downstream AI models.

This example extracts both the dialogue and the background (music + effects) stems:

Python Example

import requests

API_KEY = "your_api_key"
HEADERS = {"Content-Type": "application/json", "x-api-key": API_KEY}

response = requests.post(
    "https://api.audioshake.ai/tasks",
    headers=HEADERS,
    json={
        "assetId": "your_asset_id",
        "targets": [
            {"model": "dialogue", "formats": ["wav"]},
            {"model": "music_fx", "formats": ["wav"]}
        ]
    }
)

task_id = response.json()["id"]
print(f"Task created: {task_id}")

JavaScript Example

const API_KEY = "your_api_key";
const headers = { "Content-Type": "application/json", "x-api-key": API_KEY };

const createRes = await fetch("https://api.audioshake.ai/tasks", {
  method: "POST",
  headers,
  body: JSON.stringify({
    assetId: "your_asset_id",
    targets: [
      { model: "dialogue", formats: ["wav"] },
      { model: "music_fx", formats: ["wav"] }
    ]
  })
});

const { id: taskId } = await createRes.json();
console.log(`Task created: ${taskId}`);

cURL Example

curl -X POST "https://api.audioshake.ai/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $AUDIOSHAKE_API_KEY" \
  -d '{
    "assetId": "your_asset_id",
    "targets": [
      { "model": "dialogue", "formats": ["wav"] },
      { "model": "music_fx", "formats": ["wav"] }
    ]
  }'

Check Task status to monitor progress and download results, or use webhooks to be notified when each target completes.

Outputs

Target Role
dialogue Clean speech — use as reference or feed into translation/dubbing
music_fx Music + effects bed — layer localized voiceover on top

Use cases