설정 레퍼런스 - VOICEVOX for Laravel

config/voicevox.php의 모든 설정 항목과 환경 변수, 기본값, 설정 예시를 설명합니다.

이 페이지에서는 config/voicevox.php의 모든 설정 항목을 정리합니다.

​

설정 파일 게시

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

​

client 설정

​

client.url

• Type: string
• Default: '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

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

'client' => [
    'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
],

VOICEVOX_CLIENT_CORE_VERSION=0.15.0

​

core 설정

​

core.path

• Type: string|null
• Default: null
• Env: VOICEVOX_CORE_PATH
• Required: 네이티브 모드 / 엔진 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

• Type: string
• Default: '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

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

'core' => [
    'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
],

​

core.user_dict

• Type: string
• Default: 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

관련 페이지: 사용자 사전

​

core.presets

• Type: string
• Default: 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

관련 페이지: 프리셋

​

core.vvms

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

# 기본값 (빠른 시작)
'core' => [
    'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
],

# 전체 모델 로드 (시작이 느려짐)
'core' => [
    'vvms' => [],
],

​

engine 설정

​

engine.disabled

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

'engine' => [
    'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
],

VOICEVOX_ENGINE_DISABLED=true

​

engine.fallback_url

• Type: string
• Default: '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

• Type: string
• Default: 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.'
• Env: 없음

'engine' => [
    'fallback_error' => 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.',
],

우선은 client.url과 core.path만 설정하고, 필요해지면 core.user_dict나 core.presets를 조정하는 구성이 운용하기 쉽습니다.