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

# Create query for speech synthesis using preset

> Get initial values for speech synthesis query. The query obtained here can be used directly for speech synthesis. Refer to `Schemas` for the meaning of each value.

**Laravel Implementation Status**: ⚠️ Supported via NativePresetStore and Core's createAudioQuery. Laravel does not support enable_katakana_english. (no fallback needed)



## OpenAPI

````yaml https://raw.githubusercontent.com/invokable/laravel-voicevox/refs/heads/main/docs/en/laravel-openapi.json post /audio_query_from_preset
openapi: 3.1.0
info:
  title: VOICEVOX ENGINE OSS
  description: VOICEVOX OSS  text-to-speech synthesis engine.
  version: latest
servers: []
security: []
paths:
  /audio_query_from_preset:
    post:
      tags:
        - Query Creation
      summary: Create query for speech synthesis using preset
      description: >-
        Get initial values for speech synthesis query. The query obtained here
        can be used directly for speech synthesis. Refer to `Schemas` for the
        meaning of each value.


        **Laravel Implementation Status**: ⚠️ Supported via NativePresetStore
        and Core's createAudioQuery. Laravel does not support
        enable_katakana_english. (no fallback needed)
      operationId: audio_query_from_preset
      parameters:
        - name: text
          in: query
          required: true
          schema:
            type: string
            title: Text
        - name: preset_id
          in: query
          required: true
          schema:
            type: integer
            title: Preset Id
        - name: enable_katakana_english
          in: query
          required: false
          schema:
            type: boolean
            default: true
            title: Enable Katakana English
        - name: core_version
          in: query
          required: false
          schema:
            type: string
            title: Core Version
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioQuery'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AudioQuery:
      properties:
        accent_phrases:
          items:
            $ref: '#/components/schemas/AccentPhrase'
          type: array
          title: Accent Phrases
          description: List of accent phrases
        speedScale:
          type: number
          title: Speedscale
          description: Overall speech speed
        pitchScale:
          type: number
          title: Pitchscale
          description: Overall pitch
        intonationScale:
          type: number
          title: Intonationscale
          description: Overall intonation
        volumeScale:
          type: number
          title: Volumescale
          description: Overall volume
        prePhonemeLength:
          type: number
          title: Prephonemelength
          description: Silence duration before the audio
        postPhonemeLength:
          type: number
          title: Postphonemelength
          description: Silence duration after the audio
        pauseLength:
          anyOf:
            - type: number
            - type: 'null'
          title: Pauselength
          description: >-
            Silence duration for punctuation etc. Ignored when null. Default
            value is null.
        pauseLengthScale:
          type: number
          title: Pauselengthscale
          description: >-
            Silence duration for punctuation etc. (multiplier). Default value is
            1.
          default: 1
        outputSamplingRate:
          type: integer
          title: Outputsamplingrate
          description: Output sampling rate of the audio data
        outputStereo:
          type: boolean
          title: Outputstereo
          description: Whether to output audio data in stereo
        kana:
          type: string
          title: Kana
          description: >-
            [Read-only] Text in AquesTalk-style notation. Ignored as a query for
            speech synthesis.
      type: object
      required:
        - accent_phrases
        - speedScale
        - pitchScale
        - intonationScale
        - volumeScale
        - prePhonemeLength
        - postPhonemeLength
        - outputSamplingRate
        - outputStereo
      title: AudioQuery
      description: Query for speech synthesis.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AccentPhrase:
      properties:
        moras:
          items:
            $ref: '#/components/schemas/Mora'
          type: array
          title: Moras
          description: List of moras
        accent:
          type: integer
          title: Accent
          description: Accent position
        pause_mora:
          $ref: '#/components/schemas/Mora'
          title: Pause Mora
          description: >-
            Silent mora appended to the end of the accent phrase. If null, no
            silent mora is appended.
        is_interrogative:
          type: boolean
          title: Is Interrogative
          description: Whether the phrase is interrogative
          default: false
      type: object
      required:
        - moras
        - accent
      title: AccentPhrase
      description: Information for each accent phrase.
    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
    Mora:
      properties:
        text:
          type: string
          title: Text
          description: Character
        consonant:
          type: string
          title: Consonant
          description: Consonant phoneme
        consonant_length:
          type: number
          title: Consonant Length
          description: Consonant length
        vowel:
          type: string
          title: Vowel
          description: Vowel phoneme
        vowel_length:
          type: number
          title: Vowel Length
          description: Vowel length
        pitch:
          type: number
          title: Pitch
          description: Pitch
      type: object
      required:
        - text
        - vowel
        - vowel_length
        - pitch
      title: Mora
      description: Information for each mora (consonant + vowel).

````