Crystal-clear voice.
Anywhere your audio goes.

# export your key once per shell
export NC_API_KEY="sk_your_api_key_here"
export NC_BASE_URL="https://api-noise-cancellation.us.tech"

# 1. Ask for an upload URL
RESP=$(curl -sS -X POST "$NC_BASE_URL/v1/enhance" \
  -H "authorization: Bearer $NC_API_KEY" \
  -H "content-type: application/json" \
  --data '{"content_type": "audio/wav"}')

JOB_ID=$(echo "$RESP" | jq -r .job_id)
UPLOAD_URL=$(echo "$RESP" | jq -r .upload_url)

# 2. Upload your audio directly to the pre-signed URL
curl -sS -X PUT "$UPLOAD_URL" \
  -H "content-type: audio/wav" \
  --data-binary @my-recording.wav

import os, requests

BASE = os.environ["NC_BASE_URL"]
KEY  = os.environ["NC_API_KEY"]
HEAD = {"authorization": f"Bearer {KEY}"}

# 1. Reserve a job & get an upload URL
r = requests.post(
    f"{BASE}/v1/enhance",
    headers={**HEAD, "content-type": "application/json"},
    json={"content_type": "audio/wav"},
    timeout=10,
)
r.raise_for_status()
job        = r.json()
job_id     = job["job_id"]
upload_url = job["upload_url"]

# 2. Upload your audio directly to storage
with open("my-recording.wav", "rb") as f:
    requests.put(
        upload_url,
        data=f,
        headers={"content-type": "audio/wav"},
        timeout=60,
    ).raise_for_status()

# 3. Start the job (queues for processing)
curl -sS -X POST "$NC_BASE_URL/v1/enhance/$JOB_ID/start" \
  -H "authorization: Bearer $NC_API_KEY"

# 4. Poll until done
while true; do
  STATE=$(curl -sS "$NC_BASE_URL/v1/jobs/$JOB_ID" \
    -H "authorization: Bearer $NC_API_KEY")
  STATUS=$(echo "$STATE" | jq -r .status)
  [ "$STATUS" = "completed" ] && break
  [ "$STATUS" = "failed" ]    && exit 1
  sleep 2
done

# 5. Download the cleaned audio
DL=$(echo "$STATE" | jq -r .download_url)
curl -sS -o cleaned.wav "$DL"

import time

# 3. Start the job
requests.post(
    f"{BASE}/v1/enhance/{job_id}/start",
    headers=HEAD, timeout=10,
).raise_for_status()

# 4. Poll until done
while True:
    state = requests.get(
        f"{BASE}/v1/jobs/{job_id}",
        headers=HEAD, timeout=10,
    ).json()
    if state["status"] in ("completed", "failed"):
        break
    time.sleep(2)

if state["status"] != "completed":
    raise RuntimeError(state.get("error_message"))

# 5. Download the cleaned audio
audio = requests.get(state["download_url"], timeout=60).content
with open("cleaned.wav", "wb") as f:
    f.write(audio)