音楽

説明文だけで、またはご自身の歌詞とスタイルから、フルレングスの楽曲を生成できます。1回のリクエストで 2 テイクが生成され、料金は一律です。通常、約1分で完了します。

曲を作成する

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

曲はバックグラウンドで生成されます。POST /v1/music はすぐに ID を返すので、ステータスが completed または failed になるまで、数秒おきに GET /v1/music/{id} でその ID を問い合わせてください。

パラメータ

prompt を送信して曲を説明するか、lyrics と style を使って自分で書くこともできます。両方を同時に送信しないでください。

結果

テイクのダウンロード

MP3 を受け付けるストリームです。曲は30日間保存されます。

曲の一覧を取得する

新しい順に並びます。limit(最大100)とafter(曲のID)を指定して、ページを切り替えられます。

知っておくと便利なこと

• 課金されるのは、楽曲が納品されたときだけです。失敗した場合は無料です。
• 有名アーティストの名前を指定したり、他人の歌詞を使ったりしたリクエストは、エラーコード content_policy で拒否される場合があります。代わりに、サウンドの特徴を言葉で説明してください。
• 曲の長さはさまざまで、通常は1分未満から3分30秒ほどです。長さは指定できません。