---
title: "指定された音声合成モデルの情報を取得する"
method: GET
path: "/aivm_models/{aivm_model_uuid}"
tags: ["音声合成モデル管理"]
---

# 指定された音声合成モデルの情報を取得する

`GET /aivm_models/{aivm_model_uuid}`

指定された音声合成モデルの情報を取得します。

## Path parameters

- `aivm_model_uuid` string, required — AIVM マニフェスト記載の音声合成モデルの UUID

## Response `200`

指定された音声合成モデルの情報

- AivmInfo — AIVM (Aivis Voice Model) 仕様に準拠した音声合成モデルのメタデータ情報。 AIVM マニフェストには、音声合成モデルに関連する全てのメタデータが含まれる。 speakers フィールド内の話者情報は、VOICEVOX ENGINE との API 互換性のために、 AIVM マニフェストを基に Speaker / SpeakerStyle / SpeakerInfo / StyleInfo モデルに変換したもの。
  - `is_loaded` boolean, required — この音声合成モデルがロードされているかどうか
  - `is_update_available` boolean, required — この音声合成モデルの新しいバージョンが AivisHub で公開されているかどうか
  - `is_private_model` boolean, required — AivisHub で公開されておらず、ユーザーがローカルからインストールしたモデルの場合は True (ネットワークエラーなどで AivisHub から情報を取得できなかった場合も True を返す)
  - `is_default_model` boolean — AivisHub がデフォルトインストール対象として指定した音声合成モデルかどうか
  - `latest_version` string, required — この音声合成モデルの AivisHub で公開されている最新バージョン (AivisHub で公開されていない場合は AIVM マニフェスト記載のバージョン)
  - `file_path` string, path, required — AIVMX ファイルのインストール先パス
  - `file_size` integer, required — AIVMX ファイルのインストールサイズ (バイト単位)
  - `manifest` AivmManifest, required — AIVM マニフェストのスキーマ
    - `manifest_version` '1.0', required
    - `name` string, required
    - `description` string
    - `creators` string[]
    - `license` string, nullable
    - `model_architecture` 'Style-Bert-VITS2' | 'Style-Bert-VITS2 (JP-Extra)', required
    - `model_format` 'Safetensors' | 'ONNX', required
    - `training_epochs` integer, nullable
    - `training_steps` integer, nullable
    - `uuid` string, uuid, required
    - `version` string, required
    - `speakers` AivmManifestSpeaker[], required
      - `name` string, required
      - `icon` string, required
      - `supported_languages` string[], required
      - `uuid` string, uuid, required
      - `local_id` integer, required
      - `styles` AivmManifestSpeakerStyle[], required
        - `name` string, required
        - `icon` string, nullable
        - `local_id` integer, required
        - `voice_samples` AivmManifestVoiceSample[]
          - `audio` string, required
          - `transcript` string, required
  - `speakers` LibrarySpeaker[], required — 話者情報のリスト (VOICEVOX ENGINE 互換)
    - `speaker` Speaker, required — キャラクター情報
      - `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' は「全て禁止」
    - `speaker_info` SpeakerInfo, required — キャラクターの追加情報
      - `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)