## Make your first API call

1. **Create an account**  
   Sign up at [dashboard.audioshake.ai](https://dashboard.audioshake.ai/auth/sign-up/). You’ll get 10 free credits to start building immediately.

2. **Create an API key**  
   In the dashboard, go to **Settings > API Keys** and click **Create new key**. Copy and store the key — you will not be able to view it again.

3. **Create your first Task**  
   A Task runs one or more [models](https://developer.audioshake.ai/models) against a media source. This example separates a track into vocals and instrumental:

```
curl -X POST "https://api.audioshake.ai/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -d '{\n    "url": "https://demos.audioshake.ai/demo-assets/shakeitup.mp3",\n    "targets": [\
      { "model": "vocals", "formats": ["wav"] },\
      { "model": "instrumental", "formats": ["wav"] }\
    ]\n  }'
   ```  
   
   ```
import requests

response = requests.post(
    "https://api.audioshake.ai/tasks",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "your_api_key"
    },
    json={
        "url": "https://demos.audioshake.ai/demo-assets/shakeitup.mp3",
        "targets": [\
            {"model": "vocals", "formats": ["wav"]},\
            {"model": "instrumental", "formats": ["wav"]}\
        ]
    }
)

print(response.json()["id"])
   ```  
   
   ```
const response = await fetch("https://api.audioshake.ai/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "your_api_key"
  },
  body: JSON.stringify({
    url: "https://demos.audioshake.ai/demo-assets/shakeitup.mp3",
    targets: [\
      { model: "vocals", formats: ["wav"] },\
      { model: "instrumental", formats: ["wav"] }\
    ]
  })
});

const task = await response.json();
console.log(task.id);
   ```

Save the `id` from the response.

4. **Check Task status**  
   Tasks process asynchronously. Poll until each target’s `status` is `completed` or `error`:

```
curl "https://api.audioshake.ai/tasks/<task-id>" \
  -H "x-api-key: your_api_key"
   ```
   
   ```
task = requests.get(
    f"https://api.audioshake.ai/tasks/{task_id}",
    headers={"x-api-key": "your_api_key"}
).json()

for target in task["targets"]:
    print(f"{target['model']}: {target['status']}")
   ```
   
   ```
const res = await fetch(`https://api.audioshake.ai/tasks/${taskId}`, {
  headers: { "x-api-key": "your_api_key" }
});
const task = await res.json();

for (const target of task.targets) {
  console.log(`${target.model}: ${target.status}`);
}
   ```  
   Each completed target includes an `output` array with download links.

Output download links expire after one hour. Download and store files in your own storage.

Use [webhooks](https://developer.audioshake.ai/api-reference/tasks/webhooks) to get notified when targets complete instead of polling.

## Using a local file

Upload your file first with [Upload File](https://developer.audioshake.ai/api-reference/assets/upload), then use the returned `assetId` instead of `url`:

```json
{
  "assetId": "your_asset_id",
  "targets": [\
    { "model": "vocals", "formats": ["wav"] },\
    { "model": "instrumental", "formats": ["wav"] }\
  ]
}
```

## What’s next?

[**Models** \
\
Browse all available models.](https://developer.audioshake.ai/models)

[**Instrument Separation** \
\
Isolate vocals, drums, bass, and more.](https://developer.audioshake.ai/separate-stems)

[**Webhooks** \
\
Get notified when targets complete instead of polling.](https://developer.audioshake.ai/api-reference/tasks/webhooks)

[**API Reference** \
\
Full endpoint reference.](https://developer.audioshake.ai/api-reference/authentication)