---
title: "Frame Synthesis"
method: POST
path: "/frame_synthesis"
tags: ["音声合成"]
---

# Frame Synthesis

`POST /frame_synthesis`

歌唱音声合成を行います。

## Query parameters

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

## Request body

- 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 — 音声データをステレオ出力するか否か

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2025-03-02** `d8b6a60f88af` — 1 info
  - api operation id `frame_synthesis_frame_synthesis_post` removed and replaced with `frame_synthesis`
- **2024-10-05** `e86c0159e1bd` — 1 info
  - added the new optional request property `phonemes/items/note_id`
- **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/frame_synthesis/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)