Saltar al contenido principal
En esta página se recogen todas las opciones de config/voicevox.php.

Publicar el archivo de configuración

php artisan vendor:publish --tag="voicevox-config"

Ajustes de client

client.url

  • Tipo: string
  • Valor por defecto: 'http://127.0.0.1:50021'
  • Env: VOICEVOX_URL
'client' => [
    'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
],
VOICEVOX_URL=http://127.0.0.1:50021

client.core_version

  • Tipo: string|null
  • Valor por defecto: null
  • Env: VOICEVOX_CLIENT_CORE_VERSION
'client' => [
    'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
],
VOICEVOX_CLIENT_CORE_VERSION=0.15.0

Ajustes de core

core.path

  • Tipo: string|null
  • Valor por defecto: null
  • Env: VOICEVOX_CORE_PATH
  • Obligatorio: en modo nativo / modo Engine API
'core' => [
    'path' => env('VOICEVOX_CORE_PATH'),
],
# macOS
VOICEVOX_CORE_PATH=/Users/username/.local/voicevox_core/

# Linux
VOICEVOX_CORE_PATH=/home/username/.local/voicevox_core/

# Windows
VOICEVOX_CORE_PATH=C:\Users\username\.local\voicevox_core\

core.dict

  • Tipo: string
  • Valor por defecto: 'dict/open_jtalk_dic_utf_8-1.11'
  • Env: VOICEVOX_CORE_DICT_PATH
'core' => [
    'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
],

core.models

  • Tipo: string
  • Valor por defecto: 'models/vvms'
  • Env: VOICEVOX_CORE_MODELS_PATH
'core' => [
    'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
],

core.user_dict

  • Tipo: string
  • Valor por defecto: storage_path('voicevox/user_dict.json')
  • Env: VOICEVOX_CORE_USER_DICT_PATH
'core' => [
    'user_dict' => env('VOICEVOX_CORE_USER_DICT_PATH', storage_path('voicevox/user_dict.json')),
],
VOICEVOX_CORE_USER_DICT_PATH=/path/to/custom/user_dict.json
Página relacionada: Diccionario de usuario

core.presets

  • Tipo: string
  • Valor por defecto: storage_path('voicevox/presets.json')
  • Env: VOICEVOX_CORE_PRESETS_PATH
'core' => [
    'presets' => env('VOICEVOX_CORE_PRESETS_PATH', storage_path('voicevox/presets.json')),
],
VOICEVOX_CORE_PRESETS_PATH=/path/to/custom/presets.json
Página relacionada: Presets

core.vvms

  • Tipo: array
  • Valor por defecto: ['0.vvm', '9.vvm', 's0.vvm']
  • Env: ninguno
# Por defecto (arranque rápido)
'core' => [
    'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
],

# Cargar todos los modelos (el arranque será más lento)
'core' => [
    'vvms' => [],
],

Ajustes de engine

engine.disabled

  • Tipo: bool
  • Valor por defecto: false
  • Env: VOICEVOX_ENGINE_DISABLED
'engine' => [
    'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
],
VOICEVOX_ENGINE_DISABLED=true

engine.fallback_url

  • Tipo: string
  • Valor por defecto: 'http://127.0.0.1:50021'
  • Env: VOICEVOX_ENGINE_FALLBACK_URL
'engine' => [
    'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
],
VOICEVOX_ENGINE_FALLBACK_URL=http://127.0.0.1:50021

engine.fallback_error

  • Tipo: string
  • Valor por defecto: 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.'
  • Env: ninguno
'engine' => [
    'fallback_error' => 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.',
],
Es manejable empezar configurando solo client.url y core.path, y ajustar core.user_dict o core.presets cuando lo necesites.
Última modificación el 13 de julio de 2026