API Crear clave

SunoAudio

Cambiar una parte

Vuelve a cantar una parte de tu canción con letra nueva, y el resto se queda igual.

Precio
5 crpor trabajo
Id del modelo
audio.song-replace

Zona de pruebas

Zona de pruebas

Audio *

Inicia sesión para subir un archivo.

0 - 480

1 - 480

Más ajustes
Regístrate para ejecutarlo

Cambia los ajustes: el precio y el código se actualizan. Para ejecutarlo necesitas una cuenta.

audio.song-replace
Admite
Audio

Aún no hay un ejemplo de este modelo. Estos son sus ajustes reales.

# 0. Primero sube tu archivo y pon en params el id que imprime.
curl -s -X POST https://staglight.ai/api/v1/uploads \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" -F file=@your-file | jq -r .id

# 1. Crea el trabajo. Se cobra una vez.
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-replace",
    "params": {
      "audio": "med_your_upload_id",
      "start": 0,
      "end": 1,
      "lyrics": "Dos erizos animados dormidos en una camita, vistos desde arriba, luz suave de noche"
    },
    "max_credits": 5
  }' | jq -r .id)

# 2. Consulta hasta que termine. Cada llamada espera hasta 30 segundos.
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. Descarga el resultado desde 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. Primero sube tu archivo y pon en params el id que imprime.
with open("your-file", "rb") as f:
    print(requests.post(f"{BASE}/uploads", headers=HEADERS, files={"file": f}, timeout=300).json()["id"])

# 1. Crea el trabajo. Se cobra una vez.
r = requests.post(f"{BASE}/jobs", timeout=60,
                  headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
                  json={
                    "op": "audio.song-replace",
                    "params": {
                      "audio": "med_your_upload_id",
                      "start": 0,
                      "end": 1,
                      "lyrics": "Dos erizos animados dormidos en una camita, vistos desde arriba, luz suave de noche"
                    },
                    "max_credits": 5
                  })
r.raise_for_status()
job = r.json()

# 2. Consulta hasta que termine. Cada llamada espera hasta 30 segundos.
while job["status"] in ("queued", "running"):
    job = requests.get(f"{BASE}/jobs/{job['id']}", headers=HEADERS,
                       params={"wait": 30}, timeout=60).json()

# 3. Descarga el resultado desde outputs[0].download_url.
print(job["outputs"][0]["download_url"] if job["outputs"] else job["data"] or job["error"])
// Node 18 o posterior. Guárdalo como run.mjs: el await de nivel superior necesita un módulo.
const BASE = "https://staglight.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.STAGLIGHT_API_KEY}` };

// 0. Primero sube tu archivo y pon en params el id que imprime.
// const form = new FormData(); form.append('file', yourFile);
// const { id } = await (await fetch(`${BASE}/uploads`, { method: 'POST', headers, body: form })).json();

// 1. Crea el trabajo. Se cobra una vez.
let res = await fetch(`${BASE}/jobs`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    "op": "audio.song-replace",
    "params": {
      "audio": "med_your_upload_id",
      "start": 0,
      "end": 1,
      "lyrics": "Dos erizos animados dormidos en una camita, vistos desde arriba, luz suave de noche"
    },
    "max_credits": 5
  }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
let job = await res.json();

// 2. Consulta hasta que termine. Cada llamada espera hasta 30 segundos.
while (job.status === "queued" || job.status === "running") {
  job = await (await fetch(`${BASE}/jobs/${job.id}?wait=30`, { headers })).json();
}

// 3. Descarga el resultado desde outputs[0].download_url.
console.log(job.outputs[0]?.download_url ?? job.data ?? job.error);
{
  "id": "job_19a2b3c4d5e6f7a8b9c0d1",
  "op": "audio.song-replace",
  "status": "queued",
  "credits": 5,
  "title": "",
  "params": {
    "audio": "med_your_upload_id",
    "start": 0,
    "end": 1,
    "lyrics": "Dos erizos animados dormidos en una camita, vistos desde arriba, luz suave de noche"
  },
  "progress": null,
  "outputs": [],
  "data": null,
  "error": null,
  "run_id": null,
  "source": "api",
  "created_at": "2026-11-06T12:00:00Z",
  "finished_at": null,
  "eta_seconds": 90,
  "can_cancel": true,
  "step": "send"
}

Cuánto cuesta

5 cr por ejecución. Los ajustes no cambian el precio.

La zona de pruebas muestra el precio exacto de tus ajustes. El trabajo se cobra una vez al aceptarlo. El precio se vuelve a comprobar con tu archivo antes de ejecutar.

Parámetros

NombreTipoPor defectoValores
audioobligatorioAudio media id Audio
startobligatorioDesde (s) number 0 - 480
endobligatorioHasta (s) number 1 - 480
lyricsobligatorioLetra nueva para esta parte string Hasta 5.000 caracteres
styleEstilo string Hasta 1.000 caracteres
full_lyricsLetra completa tras el cambio string Hasta 5.000 caracteres

Envíalos dentro de params. Los archivos son ids de POST /api/v1/uploads. Ver la documentación

Más modelos