---
title: "テキストからアクセント句を得る"
method: POST
path: "/accent_phrases"
tags: ["クエリ編集"]
---

# テキストからアクセント句を得る

`POST /accent_phrases`

テキストからアクセント句を得ます。
is_kanaが`true`のとき、テキストは次のAquesTalk 風記法で解釈されます。デフォルトは`false`です。
* 全てのカナはカタカナで記述される
* アクセント句は`/`または`、`で区切る。`、`で区切った場合に限り無音区間が挿入される。
* カナの手前に`_`を入れるとそのカナは無声化される
* アクセント位置を`'`で指定する。全てのアクセント句にはアクセント位置を1つ指定する必要がある。
* アクセント句末に`？`(全角)を入れることにより疑問文の発音ができる。

## Query parameters

- `text` string, required
- `speaker` integer, required
- `is_kana` boolean
- `core_version` string, nullable

## Response `200`

Successful Response

- AccentPhrase[]
  - `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

## Other responses

- `400` — 読み仮名のパースに失敗
- `422` — Validation Error

## Changes

- **2024-03-22** `ef4da11d01e0` — 2 breaking, 4 info
  - response property `items/moras/items/consonant` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/moras/items/consonant_length` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - `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
  - …2 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
- …earlier changes not shown

[Full history](https://skmtc.dev/aivis-project/apis/aivisspeech-engine/changes/accent_phrases/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.dev/aivis-project/apis/aivisspeech-engine/revisions/e2fc361a5b2e?raw)