---
title: "Get Presets"
method: GET
path: "/presets"
tags: ["その他"]
---

# Get Presets

`GET /presets`

エンジンが保持しているプリセットの設定を返します

## Response `200`

プリセットのリスト

- Preset[]
  - `id` integer, required
  - `name` string, required
  - `speaker_uuid` string, required
  - `style_id` integer, required
  - `speedScale` number, required — 全体の話速を 0.5 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 2.0 で 2 倍速、0.5 で 0.5 倍速になる。
  - `intonationScale` number, required — 話者スタイルの声色の強弱を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 値が大きいほどそのスタイルに近い抑揚がついた声になる。 例えば話者スタイルが「うれしい」なら、値が大きいほどより嬉しそうな明るい話し方になる。 一方スタイルによっては値を大きくしすぎると不自然な棒読みボイスになりがちなので、適宜調整が必要。 全スタイルの平均であるノーマルスタイルには指定できない (値にかかわらず無視される) 。
  - `tempoDynamicsScale` number — 話す速さの緩急の強弱を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 値が大きいほどより早口で生っぽい抑揚がついた声になる。 VOICEVOX ENGINE との互換性のため、未指定時はデフォルト値が適用される。
  - `pitchScale` number, required — 全体の音高を -0.15 ~ 0.15 の範囲で指定する (デフォルト: 0.0) 。 値が大きいほど高い声になる。 VOICEVOX ENGINE と異なり、この値を 0.0 から変更すると音質が劣化するため注意が必要。
  - `volumeScale` number, required — 全体の音量を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 値が大きいほど大きな声になる。
  - `prePhonemeLength` number, required
  - `postPhonemeLength` number, required

## Changes

- **2024-05-09** `fd13ee3ebb92` — 1 warning, 1 info
  - removed the optional property `items/styleStrengthScale` from the response with the `200` status
  - added the optional property `items/tempoDynamicsScale` to the response with the `200` status
- **2024-05-02** `7d46d11815c2` — 1 info
  - added the optional property `items/styleStrengthScale` to the response with the `200` status
- **2024-04-26** `907e5011a1aa` — 1 warning
  - removed the optional property `items/styleStrengthScale` from the response with the `200` status
- **2024-03-30** `ac3a4e1af82f` — 1 info
  - added the optional property `items/styleStrengthScale` to the response with the `200` status
- **2024-01-17** `1bed97d41915` — 3 warning, 3 info
  - removed the optional property `items/pauseLength` from the response with the `200` status
  - removed the optional property `items/pauseLengthScale` from the response with the `200` status
  - removed the optional property `items/tempoDynamicsScale` from the response with the `200` status
  - api operation id `get_presets` removed and replaced with `get_presets_presets_get`
  - …2 more

[Change history](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/changes/presets/get.md)

---

[API](https://skmtc.dev/aivis-project/apis/aivisspeech-engine.md) · [All operations](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/revisions/715f105554e0?raw)