---
title: "複数まとめて音声合成する"
method: POST
path: "/multi_synthesis"
tags: ["音声合成"]
---

# 複数まとめて音声合成する

`POST /multi_synthesis`

## Query parameters

- `speaker` integer, required
- `core_version` string, nullable

## Request body

- AudioQuery[]
  - `accent_phrases` AccentPhrase[], required
    - `moras` Mora[], required
      - `text` string, required
      - `consonant` string, nullable
      - `consonant_length` number, nullable
      - `vowel` string, required
      - `vowel_length` number, required
      - `pitch` number, required
    - `accent` integer, required
    - `pause_mora` Mora — モーラ（子音＋母音）ごとの情報
      - `text` string, required
      - `consonant` string, nullable
      - `consonant_length` number, nullable
      - `vowel` string, required
      - `vowel_length` number, required
      - `pitch` number, required
    - `is_interrogative` boolean
  - `styleStrengthScale` number — 指定された話者のスタイルをどの程度全体に反映するかを指定する。 例えばスタイルが Happy ならば、この値を大きくするほど全体の話し方が明るくなる。 一方値を大きくしすぎると発声がおかしくなりがちなので、適宜調整が必要。 VOICEVOX ENGINE との互換性のため、未指定時はデフォルト値が適用される。
  - `intonationScale` number, required
  - `speedScale` number, required
  - `pitchScale` number, required
  - `volumeScale` number, required
  - `prePhonemeLength` number, required
  - `postPhonemeLength` number, required
  - `outputSamplingRate` integer, required
  - `outputStereo` boolean, required
  - `kana` string, nullable — 読み上げるテキスト。 VOICEVOX ENGINE では AquesTalk 風記法テキストが入る読み取り専用フィールドだが (音声合成時には無視される) 、AivisSpeech Engine では音声合成時に漢字や記号が含まれた通常の読み上げテキストも必要なため、苦肉の策で読み上げテキスト指定用のフィールドとして転用した。 VOICEVOX ENGINE との互換性のため None や空文字列が指定された場合も動作するが、その場合はアクセント句から自動生成されたひらがな文字列が読み上げテキストになるため、不自然なイントネーションになってしまう。 可能な限り kana に読み上げテキストを指定した上で音声合成 API に渡すことを推奨する。

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2024-03-30** `ac3a4e1af82f` — 1 info
  - added the new optional request property `items/styleStrengthScale`
- **2024-03-22** `ef4da11d01e0` — 1 warning, 6 info
  - removed `#/components/schemas/Mora` from the `items/accent_phrases/items/pause_mora` request property `allOf` list
  - `query` request parameter `core_version` list-of-types was widened by adding types `null`
  - for the `query` request parameter `core_version`, the type was generalized from `string` to no type
  - added `#/components/schemas/Mora, subschema #2` to the `items/accent_phrases/items/pause_mora` request property `anyOf` list
  - …3 more
- **2024-01-28** `2e8475c446af` — 1 breaking, 1 warning, 1 info
  - the `query` request parameter `speaker` became required
  - deleted the `query` request parameter `style_id`
  - `query` request parameter `speaker` was reactivated
- **2024-01-22** `ba5021ec9a6d` — 3 info
  - added the new optional `query` request parameter `style_id`
  - the `query` request parameter `speaker` became optional
  - `query` request parameter `speaker` was deprecated
- **2024-01-20** `2a8c9cc0823a` — 1 breaking, 1 warning, 1 info
  - the `query` request parameter `speaker` became required
  - deleted the `query` request parameter `style_id`
  - `query` request parameter `speaker` was reactivated

[Full history](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/changes/multi_synthesis/post.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-service-production.skmtc.workers.dev/v1/apis/aivis-project/aivisspeech-engine/revisions/ac3a4e1af82f/schema)