--- title: "複数まとめて音声合成する" method: POST path: "/multi_synthesis" tags: ["音声合成"] --- # 複数まとめて音声合成する `POST /multi_synthesis` ## Query parameters - `speaker` integer, required - `enable_interrogative_upspeak` boolean — AivisSpeech Engine ではサポートされていないパラメータです (常に無視されます) 。 - `core_version` string — AivisSpeech Engine ではサポートされていないパラメータです (常に無視されます) 。 ## Request body - AudioQuery[] - `accent_phrases` AccentPhrase[], required — アクセント句のリスト。 - `moras` Mora[], required — モーラのリスト - `text` string, required — 子音＋母音に対応する文字。 VOICEVOX ENGINE と異なり、感嘆符・句読点などの記号もモーラに含まれる。 記号モーラの場合、`text` には記号がそのまま、`vowel` には "pau" が設定される。 - `consonant` string — 子音の音素。 - `consonant_length` number — 子音の音長。 AivisSpeech Engine の実装上算出できないため、ダミー値として常に 0.0 が返される。 - `vowel` string, required — 母音の音素。 - `vowel_length` number, required — 母音の音長。 AivisSpeech Engine の実装上算出できないため、ダミー値として常に 0.0 が返される。 - `pitch` number, required — 音高。 AivisSpeech Engine の実装上算出できないため、ダミー値として常に 0.0 が返される。 - `accent` integer, required — アクセント箇所 - `pause_mora` Mora — モーラ（子音＋母音）ごとの情報。 - `text` string, required — 子音＋母音に対応する文字。 VOICEVOX ENGINE と異なり、感嘆符・句読点などの記号もモーラに含まれる。 記号モーラの場合、`text` には記号がそのまま、`vowel` には "pau" が設定される。 - `consonant` string — 子音の音素。 - `consonant_length` number — 子音の音長。 AivisSpeech Engine の実装上算出できないため、ダミー値として常に 0.0 が返される。 - `vowel` string, required — 母音の音素。 - `vowel_length` number, required — 母音の音長。 AivisSpeech Engine の実装上算出できないため、ダミー値として常に 0.0 が返される。 - `pitch` number, required — 音高。 AivisSpeech Engine の実装上算出できないため、ダミー値として常に 0.0 が返される。 - `is_interrogative` boolean — 疑問系かどうか - `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) 。 「全体の抑揚」ではない点で VOICEVOX ENGINE と仕様が異なる。 数値が大きいほど、選択した話者スタイルに近い感情表現が込められた声になる。 例えば話者スタイルが「上機嫌」なら、数値が大きいほどより嬉しそうな明るい話し方になる。 一方で、話者やスタイルによっては、数値を上げすぎると発声がおかしくなったり、棒読みで不自然な声になる場合もある。 正しく発声できる上限値は話者やスタイルごとに異なる。必要に応じて最適な値を見つけて調整すること。 全スタイルの平均であるノーマルスタイルでは自動で適切な感情表現が選択されるため、この値を指定しても無視される。 - `tempoDynamicsScale` number — 話す速さ（テンポ）の緩急の強弱を 0.0 ~ 2.0 の範囲で指定する (デフォルト: 1.0) 。 AivisSpeech Engine 固有のフィールドで、VOICEVOX ENGINE には存在しない。 数値が大きいほどより早口で生っぽい抑揚がついた声になる。 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 — 音声の後の無音時間 (秒)。 - `pauseLength` number, nullable — 句読点などの無音時間。null のときは無視される。デフォルト値は null 。 - `pauseLengthScale` number — 句読点などの無音時間（倍率）。デフォルト値は 1 。 - `outputSamplingRate` integer, required — 音声データの出力サンプリングレート。 - `outputStereo` boolean, required — 音声データをステレオ出力するか否か。 - `kana` string — 読み上げるテキストを指定する。「読みの AquesTalk 風記法テキスト」ではない点で VOICEVOX ENGINE と仕様が異なる。 VOICEVOX ENGINE では AquesTalk 風記法テキストが入る読み取り専用フィールドだが (音声合成時には無視される) 、AivisSpeech Engine では音声合成時に漢字や記号が含まれた通常の読み上げテキストも必要なため、苦肉の策で読み上げテキスト指定用のフィールドとして転用した。 VOICEVOX ENGINE との互換性のため None や空文字列が指定された場合も動作するが、その場合はアクセント句から自動生成されたひらがな文字列が読み上げテキストになるため、不自然なイントネーションになってしまう。 可能な限り kana に通常の読み上げテキストを指定した上で音声合成 API に渡すことを推奨する。 ## Response `200` Successful Response ## Other responses - `422` — クエリが空またはサンプリングレートが不一致 --- [API](https://skmtc.net/aivis-project/apis/aivisspeech-engine.md) · [All operations](https://skmtc.net/aivis-project/apis/aivisspeech-engine/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aivis-project/aivisspeech-engine/versions/1d935a3e31b8/schema)