---
title: "話者情報の一覧を取得する"
method: GET
path: "/speakers"
tags: ["話者情報"]
---

# 話者情報の一覧を取得する

`GET /speakers`

話者情報の一覧を返します。

## Query parameters

- `core_version` string — AivisSpeech Engine ではサポートされていないパラメータです (常に無視されます) 。

## Response `200`

Successful Response

- Speaker[]
  - `name` string, required — 名前
  - `speaker_uuid` string, required — キャラクターの UUID
  - `styles` SpeakerStyle[], required — スタイルの一覧
    - `name` string, required — スタイル名
    - `id` integer, required — スタイル ID
    - `type` 'talk' | 'singing_teacher' | 'frame_decode' | 'sing' — スタイルの種類。talk: 音声合成クエリの作成と音声合成が可能。singing_teacher: 歌唱音声合成用のクエリの作成が可能。frame_decode: 歌唱音声合成が可能。sing: 歌唱音声合成用のクエリの作成と歌唱音声合成が可能。
  - `version` string, required — キャラクターのバージョン
  - `supported_features` SpeakerSupportedFeatures — キャラクターの対応機能の情報
    - `permitted_synthesis_morphing` 'ALL' | 'SELF_ONLY' | 'NOTHING' — モーフィング機能への対応。'ALL' は「全て許可」、'SELF_ONLY' は「同じキャラクター内でのみ許可」、'NOTHING' は「全て禁止」

## Other responses

- `422` — Validation Error

## Changes

- **2025-01-04** `df13668c123d` — 2 info
  - api tag `話者情報` added
  - api tag `その他` removed
- **2025-01-03** `b7afc41080b3` — 2 info
  - api tag `その他` added
  - api tag `話者情報` removed
- **2024-12-02** `7cceffafa319` — 2 info
  - api tag `話者情報` added
  - api tag `その他` removed
- **2024-10-29** `54501f4624fd` — 1 breaking, 2 info
  - the `items/supported_features` response's property type changed from no type to `object` for status `200`
  - added the optional property `items/supported_features/permitted_synthesis_morphing` to the response with the `200` status
  - removed `#/components/schemas/SpeakerSupportedFeatures` from the `items/supported_features` response property `allOf` list for the response status `200`
- **2024-10-05** `e86c0159e1bd` — 1 breaking, 1 warning, 1 info
  - the `items/supported_features` response's property type changed from `object` to no type for status `200`
  - removed the optional property `items/supported_features/permitted_synthesis_morphing` from the response with the `200` status
  - added `#/components/schemas/SpeakerSupportedFeatures` to the `items/supported_features` response property `allOf` list for the response status `200`

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