---
title: "楽譜・歌唱音声合成用のクエリからフレームごとの音量を得る"
method: POST
path: "/sing_frame_volume"
tags: ["クエリ編集"]
---

# 楽譜・歌唱音声合成用のクエリからフレームごとの音量を得る

`POST /sing_frame_volume`

## Query parameters

- `speaker` integer, required
- `core_version` string

## Request body

- BodySingFrameVolumeSingFrameVolumePost
  - `score` Score, required — 楽譜情報。
    - `notes` Note[], required — 音符のリスト
      - `id` string, nullable — ID
      - `key` integer — 音階
      - `frame_length` integer, required — 音符のフレーム長
      - `lyric` string, required — 音符の歌詞
  - `frame_audio_query` FrameAudioQuery, required — フレームごとの音声合成用のクエリ。
    - `f0` number[], required — フレームごとの基本周波数
    - `volume` number[], required — フレームごとの音量
    - `phonemes` FramePhoneme[], required — 音素のリスト
      - `phoneme` string, required — 音素
      - `frame_length` integer, required — 音素のフレーム長
      - `note_id` string, nullable — 音符のID
    - `volumeScale` number, required — 全体の音量
    - `outputSamplingRate` integer, required — 音声データの出力サンプリングレート
    - `outputStereo` boolean, required — 音声データをステレオ出力するか否か

## Response `200`

Successful Response

- number[]

## Other responses

- `422` — Validation Error

## Changes

- **2025-03-02** `d8b6a60f88af` — 1 info
  - api operation id `sing_frame_volume_sing_frame_volume_post` removed and replaced with `sing_frame_volume`
- **2024-10-05** `e86c0159e1bd` — 2 info
  - added the new optional request property `frame_audio_query/phonemes/items/note_id`
  - added the new optional request property `score/notes/items/id`
- **2024-04-26** `907e5011a1aa` — 1 info
  - endpoint added
- **2021-08-01** `54e3a135bccf` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/voicevox/apis/voicevox-engine-oss/changes/sing_frame_volume/post.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)