クリエイティブ
Beta

creative_music_generate

接続先のワークスペースで、カタログのモデルを使って音楽生成ジョブを開始します。

操作

書き込み。読み取りと書き込みの OAuth 同意が必要です。

パラメーター

パラメーター型必須説明
body.promptstringはい曲の指示を 5,000 文字以内で指定します。
body.modelstringいいえcreative_music_models_list が返すモデル ID。既定値は orchestor/music-auto です。
body.image_urlstring または nullいいえ参照画像の公開 HTTPS URL。
body.modestringいいえすぐにジョブを受け取る場合は async を指定します。
idempotency_keystringはい同じ入力で再試行するときは同じキーを使います。
approval_receiptstringいいえ承認後の再送に使うプランのレシート。

自動選択では lyria-3-pro が選ばれます。曲の長さはプロンプトで指定します。現在のモデル一覧には秒数を直接指定できるモデルはありません。結果には MP3 の URL が含まれます。

プランを承認したら、approval_receipt を付けて同じ入力を送信します。data.job.id を creative_jobs_wait に渡し、完了後に creative_jobs_result で成果物を取得します。

依頼例

lyria-3-pro でゆっくりしたピアノ曲を作り、完了したら MP3 の URL を返して。