プリセット

新しいプリセットを追加する

新しいプリセットを追加します。

post/add_preset

Request body

idinteger required

プリセット ID 。

namestring required

プリセット名。

speaker_uuidstring required

キャラクターの UUID 。

style_idinteger required

スタイル ID 。

speedScalenumber required

全体の話速を 0.5 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 2.0 で 2 倍速、0.5 で 0.5 倍速になる。

intonationScalenumber required

選択した話者スタイルの感情表現の強弱を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。「全体の抑揚」ではない点で VOICEVOX ENGINE と仕様が異なる。数値が大きいほど、選択した話者スタイルに近い感情表現が込められた声になる。例えば話者スタイルが「上機嫌」なら、数値が大きいほどより嬉しそうな明るい話し方になる。一方で、話者やスタイルによっては、数値を上げすぎると発声がおかしくなったり、棒読みで不自然な声になる場合もある。正しく発声できる上限値は話者やスタイルごとに異なる。必要に応じて最適な値を見つけて調整すること。全スタイルの平均であるノーマルスタイルでは自動で適切な感情表現が選択されるため、この値を指定しても無視される。

tempoDynamicsScalenumber

話す速さ（テンポ）の緩急の強弱を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 AivisSpeech Engine 固有のフィールドで、VOICEVOX ENGINE には存在しない。数値が大きいほどより早口で生っぽい抑揚がついた声になる。 VOICEVOX ENGINE との互換性のため、未指定時はデフォルト値が適用される。

pitchScalenumber required

全体の音高を -0.15 ~ 0.15 の範囲で指定する (デフォルト: 0.0) 。数値が大きいほど高い声になる。 VOICEVOX ENGINE と異なり、この値を 0.0 から変更すると音質が劣化するため注意が必要。

volumeScalenumber required

全体の音量を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。数値が大きいほど大きな声になる。

prePhonemeLengthnumber required

音声の前の無音時間 (秒)。

postPhonemeLengthnumber required

音声の後の無音時間 (秒)。

pauseLengthnumber

句読点などの無音時間。null のときは無視される。デフォルト値は null 。

pauseLengthScalenumber

句読点などの無音時間（倍率）。デフォルト値は 1 。

Response

追加したプリセットのプリセットID

integer required

Changes

Changed in 18 of the 50 revisions of this API.263732

Mar 31, 2026bd7182f25e542See the full diff
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
Mar 11, 2025c5651c641b9a3See the full diff
- ○
  api tag プリセット added
  api-tag-added
- ○
  api tag その他 removed
  api-tag-removed
- ○
  added the new optional request property tempoDynamicsScale
  new-optional-request-property
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 2, 2025d8b6a60f88af13See the full diff
- ●
  removed the request property tempoDynamicsScale
  request-property-removed
- ○
  api operation id add_preset_add_preset_post removed and replaced with add_preset
  api-operation-id-removed
- ○
  api tag その他 added
  api-tag-added
- ○
  api tag プリセット removed
  api-tag-removed
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 4, 2025df13668c123d3See the full diff
- ○
  api tag プリセット added
  api-tag-added
- ○
  api tag その他 removed
  api-tag-removed
- ○
  added the new optional request property tempoDynamicsScale
  new-optional-request-property
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 3, 2025b7afc41080b312See the full diff
- ●
  removed the request property tempoDynamicsScale
  request-property-removed
- ○
  api tag その他 added
  api-tag-added
- ○
  api tag プリセット removed
  api-tag-removed
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Dec 2, 20247cceffafa3192See the full diff
- ○
  api tag プリセット added
  api-tag-added
- ○
  api tag その他 removed
  api-tag-removed
Oct 29, 202454501f4624fd1113See the full diff
- ▲
  added the new required request property id
  new-required-request-property
- ▲
  added the new required request property intonationScale
  new-required-request-property
- ▲
  added the new required request property name
  new-required-request-property
- ▲
  added the new required request property pitchScale
  new-required-request-property
- ▲
  added the new required request property postPhonemeLength
  new-required-request-property
- ▲
  added the new required request property prePhonemeLength
  new-required-request-property
- ▲
  added the new required request property speaker_uuid
  new-required-request-property
- ▲
  added the new required request property speedScale
  new-required-request-property
- ▲
  added the new required request property style_id
  new-required-request-property
- ▲
  added the new required request property volumeScale
  new-required-request-property
- ▲
  the request's body type/format changed from / to object/
  request-body-type-changed
- ●
  removed Preset from the request body allOf list
  request-body-all-of-removed
- ○
  added the new optional request property pauseLength
  new-optional-request-property
- ○
  added the new optional request property pauseLengthScale
  new-optional-request-property
- ○
  added the new optional request property tempoDynamicsScale
  new-optional-request-property
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 5, 2024e86c0159e1bd213See the full diff
- ▲
  added Preset to the request body allOf list
  request-body-all-of-added
- ▲
  the request's body type/format changed from object/ to /
  request-body-type-changed
- ●
  removed the request property id
  request-property-removed
- ●
  removed the request property intonationScale
  request-property-removed
- ●
  removed the request property name
  request-property-removed
- ●
  removed the request property pauseLength
  request-property-removed
- ●
  removed the request property pauseLengthScale
  request-property-removed
- ●
  removed the request property pitchScale
  request-property-removed
- ●
  removed the request property postPhonemeLength
  request-property-removed
- ●
  removed the request property prePhonemeLength
  request-property-removed
- ●
  removed the request property speaker_uuid
  request-property-removed
- ●
  removed the request property speedScale
  request-property-removed
- ●
  removed the request property style_id
  request-property-removed
- ●
  removed the request property tempoDynamicsScale
  request-property-removed
- ●
  removed the request property volumeScale
  request-property-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 26, 2024179894d155aa1113See the full diff
- ▲
  added the new required request property id
  new-required-request-property
- ▲
  added the new required request property intonationScale
  new-required-request-property
- ▲
  added the new required request property name
  new-required-request-property
- ▲
  added the new required request property pitchScale
  new-required-request-property
- ▲
  added the new required request property postPhonemeLength
  new-required-request-property
- ▲
  added the new required request property prePhonemeLength
  new-required-request-property
- ▲
  added the new required request property speaker_uuid
  new-required-request-property
- ▲
  added the new required request property speedScale
  new-required-request-property
- ▲
  added the new required request property style_id
  new-required-request-property
- ▲
  added the new required request property volumeScale
  new-required-request-property
- ▲
  the request's body type/format changed from / to object/
  request-body-type-changed
- ●
  removed Preset from the request body allOf list
  request-body-all-of-removed
- ○
  added the new optional request property pauseLength
  new-optional-request-property
- ○
  added the new optional request property pauseLengthScale
  new-optional-request-property
- ○
  added the new optional request property tempoDynamicsScale
  new-optional-request-property
Jul 20, 2024eb97301b5bb32See the full diff
- ○
  added the new optional request property allOf[subschema #1: Preset]/pauseLength
  new-optional-request-property
- ○
  added the new optional request property allOf[subschema #1: Preset]/pauseLengthScale
  new-optional-request-property
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (18 revisions)