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.
/v1/musicCrea una canción
import osimport timeimport requestsapi = "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 constyley sinlyrics.
El resultado
indexnumber- Qué toma es, empezando en 1. Úsalo como
trackal 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
/v1/music/{id}/content?track=1Transmisiones que admiten MP3. Las canciones se conservan durante 30 días.
Lista tus canciones
/v1/musicDel 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
¿Tienes dudas o falta algo? Escribe a nuestro equipo de soporte y te responderemos por email, normalmente en menos de un minuto.