Música

Música

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

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

Criar uma canção

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

Uma música é criada em segundo plano. POST /v1/music responde logo com um id; consulte-o com GET /v1/music/{id} a cada poucos segundos até o estado ser completed ou failed.

Parâmetros

Envie prompt para descrever uma canção ou escreva-a você mesmo com lyrics e style. Não envie ambos.

modelstringobrigatório
Um ID de modelo de música da tabela.
promptstring
Como deve ser a música, até 200 caracteres.
lyricsstring
A sua letra, até 3,000 caracteres. Marque as secções com etiquetas como [Verse] e [Chorus].
stylestring
O género, o ambiente, os instrumentos ou a voz, até 120 caracteres.
exclude_stylestring
Estilos ou instrumentos a excluir, até 120 caracteres.
titlestring
O título da canção, com um máximo de 80 caracteres.
instrumentalboolean
Sem voz. Funciona com prompt, ou com style e sem lyrics.

O resultado

Cada item em tracks
indexnumber
O número da versão, a começar em 1. Use-o como track ao transferir.
titlestring
O título da canção. O modelo escreve um se não indicar nenhum.
duration_secondsnumber
A duração do take.
stylestring
O estilo que o modelo utilizou, nas suas próprias palavras.
lyricsstring
A letra da canção. Deixe vazio para um instrumental.
urlstring
Uma ligação para o MP3, válida durante 24 horas. Volte a pedir a música para obter uma nova.

Transferir uma take

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

Streams que aceitam MP3. As músicas são guardadas durante 30 dias.

Liste as suas músicas

GET/v1/music

Do mais recente para o mais antigo. Aceita limit (até 100) e after (o id de uma música) para percorrer os resultados por páginas.

Convém saber

  • Só paga quando uma música é entregue. Se falhar, é grátis.
  • Um pedido que mencione um artista famoso, ou que use a letra de outra pessoa, pode ser recusado com o código de erro content_policy. Descreva antes o som.
  • As músicas variam em duração, normalmente entre menos de um minuto e cerca de três minutos e meio. Não é possível definir a duração.

Não é uma API oficial da Suno

A Suno não tem uma API pública própria e a Zurelay não é afiliada da Suno. Os pedidos são executados em capacidade de terceiros, por isso a disponibilidade pode mudar. Consulte os termos da Suno antes de publicar ou vender uma música.

Tem dúvidas ou falta alguma coisa? Contacte a nossa equipa de apoio e responderemos por email, normalmente num minuto.