projects

ACEStep で BGM を生成する（2クレジット）

post/api/v1/projects/{projectId}/bgm/generate

Request

  • Base URL: https://app.yukkurigen.com
  • URL: https://app.yukkurigen.com/api/v1/projects/{projectId}/bgm/generate
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

projectIdstring required

Headers

Prefer'respond-async'

respond-async を付けて呼ぶと、即座に 202 が返りジョブが作られる（RFC 7240。サーバの設定によっては付けてもジョブにならず、同期で処理して 200 を返す）。省略すると同期処理（既存互換。サーバの設定によっては、同じ受け付けのあと一定時間だけ完了を待ち、終われば同期と同じ 200 か同じ形のエラー、終わらなければ Preference-Applied なしの 202 を返す）。REST から呼ぶときは Prefer: respond-async と Idempotency-Key ヘッダを付けること（同期で処理されたときは Idempotency-Key は効かない）。完了後の result.s3AudioUrl は private S3 URL なので、playbackUrl は GET /api/v1/projects/{projectId}/bgm から取得すること。

Request body

tagsstring required

音楽スタイルを表すタグ（例: "calm, piano, lo-fi"）

durationinteger

生成する秒数（30〜240）

Response

生成成功（同期パス。Prefer なしの呼び出しをサーバが待つ設定で、待つ間にジョブが終わったときも同じ形）

successboolean
audioUrlstring
durationSecnumber
trackIdstring
playbackUrlstring

再生用の署名付き URL（1時間で失効）。保存はしないこと。保存するのは bgm_path の方

Changes

No recorded changes to this operation across all 2 revisions of this API.