---
title: "Speakers"
method: GET
path: "/speakers"
tags: ["その他"]
---

# Speakers

`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

- **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`
- **2024-09-26** `179894d155aa` — 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`
- …earlier changes not shown

[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/45e8a7c82ffc?raw)