projects

動画の尺に合わせて BGM をループ結合する（240秒ごとに2クレジット）

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

Request

  • Base URL: https://app.yukkurigen.com
  • URL: https://app.yukkurigen.com/api/v1/projects/{projectId}/bgm/pipeline
  • 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
targetDurationSecinteger required
videoUrlstring uri required

S3 上の動画URL

Response

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

successboolean
mergedUrlstring
totalDurationSecnumber
clipCountinteger
playbackUrlstring

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

Changes

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