---
title: "UUID で指定された話者の情報を取得する"
method: GET
path: "/speaker_info"
tags: ["話者情報"]
---

# UUID で指定された話者の情報を取得する

`GET /speaker_info`

UUID で指定された話者の情報を返します。
画像や音声は resource_format で指定した形式で返されます。

## Query parameters

- `speaker_uuid` string, required
- `resource_format` 'base64' | 'url'
- `core_version` string — AivisSpeech Engine ではサポートされていないパラメータです (常に無視されます) 。

## Response `200`

Successful Response

- SpeakerInfo — キャラクターの追加情報
  - `policy` string, required — policy.md
  - `portrait` string, required — アイコンを base64 エンコードしたもの、あるいは URL (「立ち絵画像を base64 エンコードしたもの」ではない点で VOICEVOX ENGINE と異なる)
  - `style_infos` StyleInfo[], required — スタイルの追加情報
    - `id` integer, required — スタイル ID
    - `icon` string, required — このスタイルのアイコンを base64 エンコードしたもの、あるいは URL
    - `portrait` string — AivisSpeech Engine では常に None を返す (「このスタイルの立ち絵画像を base64 エンコードしたもの」ではない点で VOICEVOX ENGINE と異なる)
    - `voice_samples` string[], required — ボイスサンプルの音声データを base64 エンコードしたもの、あるいは URL
    - `voice_sample_transcripts` string[] — ボイスサンプルの書き起こしテキスト (voice_samples の配列インデックスと対応し、存在しない場合は空文字列)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aivis-project/apis/aivisspeech-engine.md) · [All operations](https://skmtc.net/aivis-project/apis/aivisspeech-engine/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aivis-project/aivisspeech-engine/versions/1d935a3e31b8/schema)