Skip to main content
This page covers all settings in config/voicevox.php.

Publish the config file

client settings

client.url

  • Type: string
  • Default: 'http://127.0.0.1:50021'
  • Env: VOICEVOX_URL

client.core_version

  • Type: string|null
  • Default: null
  • Env: VOICEVOX_CLIENT_CORE_VERSION

core settings

core.path

  • Type: string|null
  • Default: null
  • Env: VOICEVOX_CORE_PATH
  • Required: Native mode and engine API mode

core.dict

  • Type: string
  • Default: 'dict/open_jtalk_dic_utf_8-1.11'
  • Env: VOICEVOX_CORE_DICT_PATH

core.models

  • Type: string
  • Default: 'models/vvms'
  • Env: VOICEVOX_CORE_MODELS_PATH

core.user_dict

  • Type: string
  • Default: storage_path('voicevox/user_dict.json')
  • Env: VOICEVOX_CORE_USER_DICT_PATH
Related page: User dictionary

core.presets

  • Type: string
  • Default: storage_path('voicevox/presets.json')
  • Env: VOICEVOX_CORE_PRESETS_PATH
Related page: Presets

core.vvms

  • Type: array
  • Default: ['0.vvm', '9.vvm', 's0.vvm']
  • Env: None

engine settings

engine.disabled

  • Type: bool
  • Default: false
  • Env: VOICEVOX_ENGINE_DISABLED

engine.fallback_url

  • Type: string
  • Default: 'http://127.0.0.1:50021'
  • Env: VOICEVOX_ENGINE_FALLBACK_URL

engine.fallback_error

  • Type: string
  • Default: 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.'
  • Env: None
Start with client.url and core.path, then adjust core.user_dict and core.presets only when you need custom file locations.
Last modified on May 28, 2026