> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

**Laravel実装状況**: ✅ コアで完全対応（フォールバック実装済み）



## OpenAPI

````yaml https://raw.githubusercontent.com/invokable/laravel-voicevox/refs/heads/main/docs/jp/laravel-openapi.json post /sing_frame_audio_query
openapi: 3.1.0
info:
  title: VOICEVOX ENGINE OSS
  description: VOICEVOX OSS の音声合成エンジンです。
  version: latest
servers: []
security: []
paths:
  /sing_frame_audio_query:
    post:
      tags:
        - クエリ作成
      summary: 歌唱音声合成用のクエリを作成する
      description: >-
        歌唱音声合成用のクエリの初期値を得ます。ここで得られたクエリはそのまま歌唱音声合成に利用できます。各値の意味は`Schemas`を参照してください。


        **Laravel実装状況**: ✅ コアで完全対応（フォールバック実装済み）
      operationId: sing_frame_audio_query
      parameters:
        - name: speaker
          in: query
          required: true
          schema:
            type: integer
            title: Speaker
        - name: core_version
          in: query
          required: false
          schema:
            type: string
            title: Core Version
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Score'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FrameAudioQuery'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Score:
      properties:
        notes:
          items:
            $ref: '#/components/schemas/Note'
          type: array
          title: Notes
          description: 音符のリスト
      type: object
      required:
        - notes
      title: Score
      description: 楽譜情報。
    FrameAudioQuery:
      properties:
        f0:
          items:
            type: number
          type: array
          title: F0
          description: フレームごとの基本周波数
        volume:
          items:
            type: number
          type: array
          title: Volume
          description: フレームごとの音量
        phonemes:
          items:
            $ref: '#/components/schemas/FramePhoneme'
          type: array
          title: Phonemes
          description: 音素のリスト
        volumeScale:
          type: number
          title: Volumescale
          description: 全体の音量
        outputSamplingRate:
          type: integer
          title: Outputsamplingrate
          description: 音声データの出力サンプリングレート
        outputStereo:
          type: boolean
          title: Outputstereo
          description: 音声データをステレオ出力するか否か
      type: object
      required:
        - f0
        - volume
        - phonemes
        - volumeScale
        - outputSamplingRate
        - outputStereo
      title: FrameAudioQuery
      description: フレームごとの音声合成用のクエリ。
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Note:
      properties:
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
          description: ID
        key:
          type: integer
          title: Key
          description: 音階
        frame_length:
          type: integer
          title: Frame Length
          description: 音符のフレーム長
        lyric:
          type: string
          title: Lyric
          description: 音符の歌詞
      type: object
      required:
        - frame_length
        - lyric
      title: Note
      description: 音符ごとの情報。
    FramePhoneme:
      properties:
        phoneme:
          type: string
          title: Phoneme
          description: 音素
        frame_length:
          type: integer
          title: Frame Length
          description: 音素のフレーム長
        note_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Note Id
          description: 音符のID
      type: object
      required:
        - phoneme
        - frame_length
      title: FramePhoneme
      description: 音素の情報。
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````