---
title: "プロジェクトの BGM を再生用の署名付き URL で取得する"
method: GET
path: "/api/v1/projects/{projectId}/bgm"
tags: ["projects"]
---

# プロジェクトの BGM を再生用の署名付き URL で取得する

`GET /api/v1/projects/{projectId}/bgm`

## Request

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

## Path parameters

- `projectId` string, required

## Response `200`

取得成功。BGM が無ければ bgmPath と playbackUrl は null

- object
  - `bgmPath` string, nullable: 保存されている S3 の URL（そのままでは読めない）
  - `playbackUrl` string, nullable: 再生用の署名付き URL（1時間で失効）
  - `backgroundUrl` string, nullable: ループ映像の署名付き URL（1時間で失効）

## Other responses

- `401`: 未認証（code: unauthenticated）
- `403`: 権限不足（projects:read / code: insufficient_scope）
- `404`: プロジェクトが見つからない（code: not_found）

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)