---
title: "Singers"
method: GET
path: "/singers"
tags: ["その他"]
---

# Singers

`GET /singers`

歌えるキャラクターの情報の一覧を返します。

## Query parameters

- `core_version` string

## 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-03-02** `d8b6a60f88af` — 1 info
  - api operation id `singers_singers_get` removed and replaced with `singers`
- **2025-01-03** `b7afc41080b3` — 1 breaking, 2 info
  - the `items/supported_features` response's property type/format changed from ``/`` 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-06-28** `3b94f9a50fd2` — 1 breaking, 3 warning, 3 info
  - the `items/supported_features/allOf[subschema #1: SpeakerSupportedFeatures]/permitted_synthesis_morphing` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - added the new `ALL` enum value to the `items/supported_features/allOf[subschema #1: SpeakerSupportedFeatures]/permitted_synthesis_morphing` response property for the response status `200`
  - added the new `NOTHING` enum value to the `items/supported_features/allOf[subschema #1: SpeakerSupportedFeatures]/permitted_synthesis_morphing` response property for the response status `200`
  - added the new `SELF_ONLY` enum value to the `items/supported_features/allOf[subschema #1: SpeakerSupportedFeatures]/permitted_synthesis_morphing` response property for the response status `200`
  - …3 more
- **2024-01-31** `2aeffeaee726` — 1 info
  - endpoint added
- …earlier changes not shown

[Full history](https://skmtc.dev/voicevox/apis/voicevox-engine-oss/changes/singers/get.md)

---

[API](https://skmtc.dev/voicevox/apis/voicevox-engine-oss.md) · [All operations](https://skmtc.dev/voicevox/apis/voicevox-engine-oss/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voicevox/voicevox-engine-oss/revisions/fbe86976d6b9/schema)