---
title: "行の bgm / effect に書ける音の一覧"
method: GET
path: "/api/v1/audio-library"
tags: ["assets"]
---

# 行の bgm / effect に書ける音の一覧

`GET /api/v1/audio-library`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/audio-library`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

音の一覧

- object
  - `bgm` object[], required
    - `name` string, required
    - `path` string, required
  - `effects` string[], required
  - `uploaded` object, required
    - `bgm` object[]
      - `name` string
      - `url` string: 行の bgm / effect に書ける url
      - `assetId` string
      - `mimeType` string, nullable
      - `fileSizeBytes` integer, nullable
      - `createdAt` string, date-time, nullable
    - `sfx` object[]
      - `name` string
      - `url` string: 行の bgm / effect に書ける url
      - `assetId` string
      - `mimeType` string, nullable
      - `fileSizeBytes` integer, nullable
      - `createdAt` string, date-time, nullable
  - `none` 'none'
  - `note` string

## Other responses

- `401`: 認証エラー（code: unauthenticated）
- `403`: スコープ不足（code: insufficient_scope。projects:read が必要）
- `500`: 読めなかった（code: internal_error）

## Changes

- **2026-10-20** `ba5f36b016da`: 15 warning, 9 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `500`
  - added the new `render_not_paid` enum value to the `code` response property for the response status `401`
  - …20 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/audio-library/get.md)

---

[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)