---
title: "プロジェクトの設定を焼かずに変える（動画全体の読み上げの再生速度・BGM のダッキング・声だけのキャラ）"
method: PATCH
path: "/api/v1/projects/{projectId}/settings"
tags: ["projects"]
---

# プロジェクトの設定を焼かずに変える（動画全体の読み上げの再生速度・BGM のダッキング・声だけのキャラ）

`PATCH /api/v1/projects/{projectId}/settings`

## Request

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

## Path parameters

- `projectId` string, required

## Request body

- object
  - `voicePlaybackRate` number, nullable: 動画全体の読み上げの再生速度（0.5〜2.0。既定 1.1）。焼くときと共有リンクで音声の再生に掛かる（音声の作り直しは要らない）。プロジェクトの voice_playback_rate に残り、共有リンク・あとの render も同じ速さになる。行ごとの速さ・高さは script[].voice（掛け合わせ）。null で既定（1.1）に戻す。
  - `bgmDucking` boolean, nullable: true で話している間だけ BGM を下げる（約 -10dB・0.15 秒で下げ 0.4 秒で戻す。間・アイキャッチでは元の大きさ）。false で下げない。null でプロジェクトの指定を外す（テンプレートの bgm.ducking に従う。それも無ければ下げない）。

## Response `200`

変えた

- object
  - `projectId` string, required
  - `voicePlaybackRate` number, required: 効いている再生速度（既定なら 1.1）
  - `voicePlaybackRateIsDefault` boolean, required
  - `note` string
  - `bgmDucking` boolean, nullable, required: プロジェクトの指定（null はテンプレートの bgm.ducking に従う）
  - `voiceOnly` string[], required: 声だけのキャラ（無ければ []）

## Other responses

- `400`: 範囲の外・知らない項目・変える項目が無い・voiceOnly が台本で話さないキャラ・舞台や action / camera に使われている（validation_error。invalidVoiceOnly / voiceOnlyOnStage / invalidAction / invalidCameraTarget と conflictLines）
- `401`: 未認証
- `403`: 権限不足（projects:write）・他人のプロジェクト（forbidden）
- `404`: プロジェクトが無い（not_found）
- `500`: 書けなかった（internal_error）。そのまま再試行してよい

## Changes

- **2026-10-20** `ba5f36b016da`: 25 warning, 15 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `400`
  - 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 `404`
  - …36 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/projects/:projectId/settings/patch.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)