SunoAudio
Change the singer
Your whole song sung again, the melody kept, asking for a man or a woman.
- Price
- 12 crper take
- Model id
audio.song-voice
Playground
audio.song-voice
- Voices
- 2
- 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-voice",
"params": {
"audio": "med_your_upload_id",
"voice": "f"
},
"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-voice",
"params": {
"audio": "med_your_upload_id",
"voice": "f"
},
"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-voice",
"params": {
"audio": "med_your_upload_id",
"voice": "f"
},
"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); Use the Staglight API to run the workflow "Change the singer" from server code.
Docs: https://staglight.ai/llms.txt
This workflow: https://staglight.ai/en/api/models/audio.song-voice
Key: read it from the STAGLIGHT_API_KEY environment variable. Never put it in browser code.
1. Price it for free first: POST /api/v1/estimate
2. Start it: POST /api/v1/jobs, with an Idempotency-Key header and max_credits.
Body: {"op": "audio.song-voice", "params": {"audio": "med_your_upload_id", "voice": "f"}, "max_credits": 12}
Files are media ids from POST /api/v1/uploads.
3. After a timeout, check the job list before you retry, and retry with the same Idempotency-Key.
4. Poll the run until it finishes, then download its outputs.zip. {
"id": "job_19a2b3c4d5e6f7a8b9c0d1",
"op": "audio.song-voice",
"status": "queued",
"credits": 12,
"title": "",
"params": {
"audio": "med_your_upload_id",
"voice": "f"
},
"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
| Name | Type | Default | Allowed |
|---|---|---|---|
audiorequiredAudio | media id | Audio | |
voicerequiredSinger | enum | f | 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
- Audioaudio.tts
- Voices
- 66
- Languages
- 7
- Takes
- Text
ElevenLabs / Voiceover
Voiceover from your script with ElevenLabs, with word timings for captions.
5 crper take · varies with length or size
- Audioaudio.music
- Length
- 10-360 s
- Takes
- Text
Suno / Music
Two tracks per take with Suno.
12 crper take · 30 s
- Audioaudio.sfx
- Takes
- Text
Suno / Sound effects
Short effects from a description: hits, ambience and transitions.
3 crper take