Música

Música

Crea canciones completas a partir de una descripción, o con tu propia letra y estilo. Cada solicitud genera 2 versiones por un solo precio y normalmente termina en alrededor de un minuto.

POST/v1/music
ModeloIDPrecio por canción

Crea una canción

import os
import time
import requests
api = "https://api.zurelay.com/v1"
headers = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
song = requests.post(f"{api}/music", headers=headers, json={
"model": "suno-v6",
"prompt": "A cheerful acoustic folk song about morning coffee",
}).json()
while song["status"] in ("queued", "in_progress"):
time.sleep(5)
song = requests.get(f"{api}/music/{song['id']}", headers=headers).json()
for track in song["tracks"]:
print(track["title"], track["url"])

La canción se genera en segundo plano. POST /v1/music responde de inmediato con un id; consúltalo con GET /v1/music/{id} cada pocos segundos hasta que su estado sea completed o failed.

Parámetros

Envía prompt para describir una canción, o escríbela tú mismo con lyrics y style. No envíes ambos.

modelstringobligatorio
Un ID de modelo de música de la tabla.
promptstring
Cómo debe ser la canción, hasta 200 caracteres.
lyricsstring
Tu propia letra, de hasta 3,000 caracteres. Marca las secciones con etiquetas como [Verse] y [Chorus].
stylestring
El género, el estado de ánimo, los instrumentos o la voz, hasta 120 caracteres.
exclude_stylestring
Estilos o instrumentos que quieres excluir, hasta 120 caracteres.
titlestring
El título de la canción, de hasta 80 caracteres.
instrumentalboolean
Sin voces. Funciona con prompt, o con style y sin lyrics.

El resultado

Cada elemento de tracks
indexnumber
Qué toma es, empezando en 1. Úsalo como track al descargar.
titlestring
El título de la canción. Si no lo indicas, el modelo escribe uno.
duration_secondsnumber
Duración de la toma.
stylestring
El estilo que usó el modelo, en sus propias palabras.
lyricsstring
La letra de la canción. Déjalo vacío para un instrumental.
urlstring
Un enlace al MP3, válido durante 24 horas. Vuelve a consultar la canción para obtener uno nuevo.

Descarga una toma

GET/v1/music/{id}/content?track=1

Transmisiones que admiten MP3. Las canciones se conservan durante 30 días.

Lista tus canciones

GET/v1/music

Del más reciente al más antiguo. Acepta limit (hasta 100) y after (el id de una canción) para paginar los resultados.

Conviene saberlo

  • Solo se te cobra cuando se entrega una canción. Si falla, es gratis.
  • Una solicitud que mencione a un artista famoso o use letras de otra persona puede ser rechazada con el código de error content_policy. Describe el sonido en su lugar.
  • La duración de las canciones varía, normalmente de menos de un minuto a unos tres minutos y medio. No se puede configurar la duración.

No es una API oficial de Suno

Suno no tiene una API pública propia, y Zurelay no está afiliado a Suno. Las solicitudes se ejecutan con capacidad de terceros, por lo que la disponibilidad puede cambiar. Revisa los términos de Suno antes de publicar o vender una canción.

¿Tienes dudas o falta algo? Escribe a nuestro equipo de soporte y te responderemos por email, normalmente en menos de un minuto.