---
title: "歌唱音声合成用のクエリを作成する"
method: POST
path: "/sing_frame_audio_query"
tags: ["クエリ作成"]
---

# 歌唱音声合成用のクエリを作成する

`POST /sing_frame_audio_query`

歌唱音声合成用のクエリの初期値を得ます。ここで得られたクエリはそのまま歌唱音声合成に利用できます。各値の意味は`Schemas`を参照してください。

## Query parameters

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

## Request body

- Score — 楽譜情報。
  - `notes` Note[], required — 音符のリスト
    - `id` string, nullable — ID
    - `key` integer — 音階
    - `frame_length` integer, required — 音符のフレーム長
    - `lyric` string, required — 音符の歌詞

## Response `200`

Successful Response

- FrameAudioQuery — フレームごとの音声合成用のクエリ。
  - `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 — 音声データをステレオ出力するか否か

## Other responses

- `422` — Validation Error

## Changes

- **2025-03-02** `d8b6a60f88af` — 1 info
  - api operation id `sing_frame_audio_query_sing_frame_audio_query_post` removed and replaced with `sing_frame_audio_query`
- **2024-10-05** `e86c0159e1bd` — 2 info
  - added the new optional request property `notes/items/id`
  - added the optional property `phonemes/items/note_id` to the response with the `200` status
- **2024-01-28** `2e8475c446af` — 1 breaking, 1 warning, 1 info
  - the `query` request parameter `speaker` became required
  - deleted the `query` request parameter `style_id`
  - `query` request parameter `speaker` was reactivated
- **2024-01-22** `ba5021ec9a6d` — 1 info
  - endpoint added
- **2024-01-20** `2a8c9cc0823a` — 1 breaking
  - api path removed without deprecation

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