Música

Música

Crie músicas completas a partir de uma descrição, ou da sua própria letra e estilo. Cada requisição gera 2 versões por um único preço e costuma ser concluída em cerca de um minuto.

POST/v1/music
ModeloIDPreço por música

Crie uma música

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"])

A música é criada em segundo plano. POST /v1/music responde na hora com um id; consulte-o com GET /v1/music/{id} a cada poucos segundos até que o status seja completed ou failed.

Parâmetros

Envie prompt para descrever uma música ou escreva você mesmo com lyrics e style. Não envie os dois.

modelstringobrigatório
Um ID de modelo de música da tabela.
promptstring
Como a música deve ser, em até 200 caracteres.
lyricsstring
Sua própria letra, com até 3,000 caracteres. Marque as seções com tags como [Verse] e [Chorus].
stylestring
O gênero, o clima, os instrumentos ou a voz, com até 120 caracteres.
exclude_stylestring
Estilos ou instrumentos a evitar, com até 120 caracteres.
titlestring
O título da música, com até 80 caracteres.
instrumentalboolean
Sem vocais. Funciona com prompt, ou com style e sem lyrics.

O resultado

Cada item em tracks
indexnumber
Qual é a tomada, começando em 1. Use como track ao baixar.
titlestring
O título da música. O modelo cria um se você não informar.
duration_secondsnumber
Duração do take.
stylestring
O estilo que o modelo usou, nas próprias palavras dele.
lyricsstring
A letra da música. Deixe em branco para uma faixa instrumental.
urlstring
Um link para o MP3, válido por 24 horas. Busque a música novamente para obter um novo.

Baixe uma take

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

Streams que aceitam MP3. As músicas ficam salvas por 30 dias.

Liste suas músicas

GET/v1/music

Mais recentes primeiro. Aceita limit (até 100) e after (o id de uma música) para paginar os resultados.

Bom saber

  • Você só é cobrado quando uma música é entregue. Se falhar, não custa nada.
  • Uma solicitação que cite um artista famoso ou use a letra de outra pessoa pode ser recusada com o código de erro content_policy. Descreva o som em vez disso.
  • As músicas variam em duração, geralmente de menos de um minuto a cerca de três minutos e meio. Não é possível definir a duração.

Não é uma API oficial do Suno

A Suno não tem uma API pública própria, e a Zurelay não é afiliada à Suno. As requisições rodam em capacidade de terceiros, então a disponibilidade pode mudar. Confira os termos da Suno antes de publicar ou vender uma música.

Tem dúvidas ou falta algo? Fale com nossa equipe de suporte e responderemos por e-mail, geralmente em até um minuto.