API Get key

SunoAudio

Add a voice

A singer over your instrumental, with your words.

Price
12 crper take
Model id
audio.song-vocals

Playground

Playground

Audio *

Sign in to upload a file.

Singer
More settings
Sign up to run it

Change the settings: the price and the code follow. You need an account to run it.

audio.song-vocals
Voices
3
Takes
Audio

No example of this model yet. These are its real settings.

# 0. Upload your file first and put the id it prints in params.
curl -s -X POST https://staglight.ai/api/v1/uploads \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" -F file=@your-file | jq -r .id

# 1. Create the job. It is charged once.
JOB_ID=$(curl -s -X POST https://staglight.ai/api/v1/jobs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "op": "audio.song-vocals",
    "params": {
      "audio": "med_your_upload_id",
      "lyrics": "Two cartoon hedgehogs asleep side by side in a small bed, seen from above, soft night light"
    },
    "max_credits": 12
  }' | jq -r .id)

# 2. Poll until it finishes. Each call waits up to 30 seconds.
while :; do
  JOB=$(curl -s "https://staglight.ai/api/v1/jobs/$JOB_ID?wait=30" -H "Authorization: Bearer $STAGLIGHT_API_KEY")
  case "$(echo "$JOB" | jq -r .status)" in queued|running) ;; *) break ;; esac
done

# 3. Download the result from outputs[0].download_url.
DOWNLOAD_URL=$(echo "$JOB" | jq -r '.outputs[0].download_url')
curl -L -o result.mp3 "$DOWNLOAD_URL"
import os, uuid, requests

BASE = "https://staglight.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['STAGLIGHT_API_KEY']}"}

# 0. Upload your file first and put the id it prints in params.
with open("your-file", "rb") as f:
    print(requests.post(f"{BASE}/uploads", headers=HEADERS, files={"file": f}, timeout=300).json()["id"])

# 1. Create the job. It is charged once.
r = requests.post(f"{BASE}/jobs", timeout=60,
                  headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
                  json={
                    "op": "audio.song-vocals",
                    "params": {
                      "audio": "med_your_upload_id",
                      "lyrics": "Two cartoon hedgehogs asleep side by side in a small bed, seen from above, soft night light"
                    },
                    "max_credits": 12
                  })
r.raise_for_status()
job = r.json()

# 2. Poll until it finishes. Each call waits up to 30 seconds.
while job["status"] in ("queued", "running"):
    job = requests.get(f"{BASE}/jobs/{job['id']}", headers=HEADERS,
                       params={"wait": 30}, timeout=60).json()

# 3. Download the result from outputs[0].download_url.
print(job["outputs"][0]["download_url"] if job["outputs"] else job["data"] or job["error"])
// Node 18 or newer. Save as run.mjs: top-level await needs a module.
const BASE = "https://staglight.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.STAGLIGHT_API_KEY}` };

// 0. Upload your file first and put the id it prints in params.
// const form = new FormData(); form.append('file', yourFile);
// const { id } = await (await fetch(`${BASE}/uploads`, { method: 'POST', headers, body: form })).json();

// 1. Create the job. It is charged once.
let res = await fetch(`${BASE}/jobs`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    "op": "audio.song-vocals",
    "params": {
      "audio": "med_your_upload_id",
      "lyrics": "Two cartoon hedgehogs asleep side by side in a small bed, seen from above, soft night light"
    },
    "max_credits": 12
  }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
let job = await res.json();

// 2. Poll until it finishes. Each call waits up to 30 seconds.
while (job.status === "queued" || job.status === "running") {
  job = await (await fetch(`${BASE}/jobs/${job.id}?wait=30`, { headers })).json();
}

// 3. Download the result from outputs[0].download_url.
console.log(job.outputs[0]?.download_url ?? job.data ?? job.error);
{
  "id": "job_19a2b3c4d5e6f7a8b9c0d1",
  "op": "audio.song-vocals",
  "status": "queued",
  "credits": 12,
  "title": "",
  "params": {
    "audio": "med_your_upload_id",
    "lyrics": "Two cartoon hedgehogs asleep side by side in a small bed, seen from above, soft night light"
  },
  "progress": null,
  "outputs": [],
  "data": null,
  "error": null,
  "run_id": null,
  "source": "api",
  "created_at": "2026-11-06T12:00:00Z",
  "finished_at": null,
  "eta_seconds": 120,
  "can_cancel": true,
  "step": "send"
}

What it costs

12 cr per run. The settings do not change the price.

The playground shows the exact price for your settings. A job is charged once when it is accepted. The price is checked again with your file before it runs.

Parameters

NameTypeDefaultAllowed
audiorequiredAudio media id Audio
lyricsrequiredLyrics string Up to 5,000 characters
voiceSinger enum any any, f, m
styleStyle string Up to 1,000 characters

Send these inside params. Files are media ids from POST /api/v1/uploads. View documentation

More models